프로젝트 소개

## 개요 MCP for Unity는 AI 어시스턴트(Claude, Codex, VS Code, 로컬 LLM 및 모든 MCP 호환 클라이언트)를 Model Context Protocol을 사용하여 Unity Editor에 연결하는 오픈소스 브리지입니다. 개발자는 자연어로 Unity를 제어할 수 있습니다. 씬과 GameObject 생성, C# 스크립트 편집, 에셋 관리, 테스트 실행, 프로파일링, 프로젝트 빌드가 가능합니다. 이 프로젝트는 MIT 라이선스로 무료이며 Aura가 유지 관리하며, Aura for Unity라는 프리미엄 동반 도구도 있습니다. ## 주요 기능 - **47개 MCP 도구 진입점** — 씬 생성, 에셋 관리, 스크립트 편집, 테스트, 프로파일링, 빌드 자동화를 포괄합니다. - **모든 MCP 클라이언트 지원** — Claude Desktop/Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI를 포함합니다. - **Unity 버전 호환성** — 2021.3 LTS부터 6.x까지. - **다중 인스턴스 라우팅** — 여러 Unity 에디터를 동시에 사용할 수 있습니다. - **도구 그룹** (vfx, animation, ui, testing 등) — 체계적인 워크플로를 지원합니다. - **Roslyn 기반 스크립트 검증** — 실행 전에 오류를 잡아냅니다. - **원격 서버 지원** — 호스팅 배포를 위한 인증 기능. ## 빠른 시작 1. Unity Package Manager에서 git URL을 사용하여 설치합니다: `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main` (또는 `#v10.0.0` 같은 릴리스 태그로 고정). 2. `Window → MCP for Unity → Configure All Detected Clients`를 통해 클라이언트를 구성합니다. 3. 프롬프트를 시작합니다. 예: "원점에 큐브를 만들고 Rigidbody를 추가해줘." ## 요구 사항 - Unity 2021.3 LTS 이상 (6.x까지) - Python 3.10+ (`uv`로 관리) - MCP 호환 AI 클라이언트 ## 고급 사용법 - **다중 인스턴스 라우팅**: 특정 Unity 인스턴스로 명령을 라우팅합니다. - **도구 그룹**: 집중적인 워크플로를 위해 도구 카테고리를 활성화/비활성화합니다. - **v10 마이그레이션**: 에셋 생성 변경에 대한 업그레이드 노트. - **Roslyn 검증**: 서버 측 C# 스크립트 검증. - **원격 서버 인증**: 인증을 통한 안전한 원격 호스팅. ## 커뮤니티 및 지원 - Discord: 유지 관리자 및 기여자 대화 - GitHub Issues: 버그 및 기능 요청 - GitHub Discussions: 설계 아이디어 - SECURITY.md: 비공개 취약점 보고 ## 인용 연구에 사용된 경우 인용: Wu, Shutong and Barnett, Justin P. "MCP-Unity: Protocol-Driven Framework for Interactive 3D Authoring." SA Technical Communications '25. DOI: 10.1145/3757376.3771417. ## 라이선스 MIT — 상업적 및 개인적 사용 무료. Unity Technologies와 제휴하지 않습니다.