설치 (Git URL)

Step 1: Package Manager에서 설치

1. Unity에서 Window > Package Manager 열기
2. 좌측 상단 + 버튼 클릭
3. Add package from git URL... 선택
4. 아래 URL 붙여넣기:

https://github.com/HaD0Yun/unity-mcp-mixamo.git?path=unity-helper

5. Add 클릭

Step 2: 자동 설정

설치 즉시 자동으로:

• MCP 서버 다운로드 (mixamo-mcp.exe)
• Claude Desktop 설정 자동 구성
• 설정 창 자동 열림

설치 후 Claude Desktop을 재시작하세요!

Step 3: Mixamo 토큰 설정

1. Window > Mixamo MCP 메뉴 클릭
2. 브라우저에서 mixamo.com 로그인
3. F12 → Console 탭에서 실행:

copy(localStorage.access_token)

4. 복사된 토큰을 창에 붙여넣고 Save 클릭

설치 완료!

이제 AI에게 말하세요:

"walk 애니메이션 다운로드해줘"

"idle, run, jump 애니메이션 한번에 다운로드"

수동 설치 (선택사항)

자동 설치가 안 될 경우:

1. Window > Mixamo MCP 열기
2. Download & Install 버튼 클릭
3. 사용할 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 생성

1. 애니메이션 폴더 선택
2. 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