설치 (Git URL)
Step 1: Package Manager에서 설치
- Unity에서 Window > Package Manager 열기
- 좌측 상단 + 버튼 클릭
- Add package from git URL... 선택
- 아래 URL 붙여넣기:
https://github.com/HaD0Yun/unity-mcp-mixamo.git?path=unity-helper
- Add 클릭
Step 2: 자동 설정
설치 즉시 자동으로:
- MCP 서버 다운로드 (
mixamo-mcp.exe) - Claude Desktop 설정 자동 구성
- 설정 창 자동 열림
설치 후 Claude Desktop을 재시작하세요!
Step 3: Mixamo 토큰 설정
- Window > Mixamo MCP 메뉴 클릭
- 브라우저에서 mixamo.com 로그인
F12→ Console 탭에서 실행:
copy(localStorage.access_token)
- 복사된 토큰을 창에 붙여넣고 Save 클릭
설치 완료!
이제 AI에게 말하세요:
"walk 애니메이션 다운로드해줘"
"idle, run, jump 애니메이션 한번에 다운로드"
수동 설치 (선택사항)
자동 설치가 안 될 경우:
- Window > Mixamo MCP 열기
- Download & Install 버튼 클릭
- 사용할 AI 도구의 Configure 버튼 클릭
MCP 명령어
| 명령어 | 설명 | 예시 |
|---|---|---|
mixamo-search | 애니메이션 검색 | mixamo-search keyword="walk" |
mixamo-download | 단일 다운로드 | mixamo-download animationIdOrName="idle" |
mixamo-batch | 배치 다운로드 | mixamo-batch animations="idle,walk,run" |
지원 키워드
| 카테고리 | 키워드 |
|---|---|
| 이동 | idle walk run jump crouch climb |
| 전투 | attack punch kick sword block death |
| 감정 | wave bow clap cheer laugh talk |
| 댄스 | dance hip hop salsa breakdance |
Unity 자동화 기능
자동 Humanoid 설정
Animations 또는 Mixamo 폴더에 FBX 파일 넣으면 자동으로 Humanoid 리그 설정됨
Animator Controller 생성
- 애니메이션 폴더 선택
- Tools > Mixamo Helper > Create Animator from Selected Folder
설치 구조
%LOCALAPPDATA%/MixamoMCP/
└── mixamo-mcp.exe ← MCP 서버 (자동 다운로드)
%APPDATA%/Claude/
└── claude_desktop_config.json ← 자동 구성
문제 해결
| 문제 | 해결 |
|---|---|
| 자동 설치가 안 됨 | Window > Mixamo MCP에서 수동 설치 |
| AI에서 mixamo 도구가 안 보임 | AI 도구 완전히 종료 후 재시작 |
| "Token expired" 에러 | mixamo.com에서 새 토큰 복사 |
| 다운로드 실패 | 방화벽/VPN 확인, GitHub 접근 가능한지 확인 |
| 재설치 필요 | Window > Mixamo MCP > Reset Installation |
라이센스
MIT License