CoplayDev/unity-mcp

MCP for Unity – AI 기반 Unity 에디터 제어

이것이 무엇인가

• 오픈소스 Unity 패키지로, 대규모 언어 모델(Claude, Codex, Gemini, 로컬 LLM 등)과 대화하고 이를 통해 Unity 에디터를 조작할 수 있게 해줍니다. Model Context Protocol(MCP)을 구현하여 MCP 호환 클라이언트가 자연어 명령을 내릴 수 있습니다.

주요 기능

• 씬 및 GameObject 생성 – 모델에게 큐브, 조명, 프리팹 등을 추가하도록 요청할 수 있습니다.
• C# 스크립트 편집 – 스크립트를 생성하거나 수정하며, Roslyn 검증을 통해 에디터에 도달하기 전에 구문 오류를 잡아냅니다.
• 에셋 관리 – 채팅을 통해 에셋을 가져오기, 이동, 이름 변경, 삭제를 수행합니다.
• 테스트 및 프로파일링 – 단위 테스트 실행, 프로파일링 세션 시작, 결과 검색.
• 빌드 자동화 – 모든 대상 플랫폼에 대한 빌드를 트리거합니다.
• 도구 카탈로그 – UI, VFX, 애니메이션, 테스트 등을 포함한 50개의 사전 정의된 "도구 진입점".
• 다중 인스턴스 라우팅 – 단일 클라이언트에서 여러 Unity 에디터 인스턴스를 제어합니다.
• 원격 서버 모드 – 인증과 함께 다른 머신에서 MCP 브리지를 호스팅합니다.

시작하는 방법

1. Unity의 패키지 관리자에서 git URL을 사용하여 패키지를 추가합니다:

   https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
   

   (안정적인 릴리스를 위해 #v10.0.0과 같은 태그를 고정하거나 OpenUPM을 사용: openupm add com.coplaydev.unity-mcp).
2. Window → MCP for Unity → Configure All Detected Clients를 엽니다 – UI가 설치된 MCP 클라이언트(Claude Desktop, Cursor, VS Code 등)를 스캔하고 통신 브리지를 설정합니다.
3. MCP 클라이언트에서 자연어 프롬프트를 입력합니다. 예: "원점에 큐브를 만들고 Rigidbody를 추가하세요." – 몇 초 안에 씬에 큐브가 나타납니다.

대상 사용자

• 평범한 언어로 변경 사항을 설명하여 더 빠르게 프로토타입하거나 반복하려는 게임 개발자.
• AI 지원 콘텐츠 제작 파이프라인을 실험하는 스튜디오.
• 3D 저작 환경에서 인간-AI 상호작용을 연구하는 연구자.

커뮤니티 및 지원

• 실시간 도움말 및 기능 논의를 위한 Discord.
• 버그 신고, 기능 요청, 디자인 아이디어를 위한 GitHub Issues & Discussions.
• https://coplaydev.github.io/unity-mcp/에서 상세 문서, 마이그레이션 가이드, 전체 도구 참조를 제공합니다.

라이선스

• MIT – 상업적 및 비상업적 용도로 무료입니다.

관련 프로젝트

• Aura(스폰서)는 Unity/Unreal용 프리미엄 AI 어시스턴트를 제공합니다.
• 같은 팀이 Godot 엔진용 유사한 도구인 Godot AI를 유지 관리합니다.

---

연구에서 MCP for Unity를 사용하는 경우, 관련 ACM 논문(Wu & Barnett, 2025)을 인용하세요.