---

설치 (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

---