IvanMurzak/Unity-MCP

Unity-MCP – AI 기반 게임 개발 어시스턴트

정의 – Claude, OpenAI Codex, Cursor, GitHub Copilot, Gemini 등과 같은 대규모 언어 모델(LLM) 에이전트를 Unity 에디터및 런타임의 빌드된 게임에 연결할 수 있는 Unity 패키지입니다. 이 플러그인은 AI 에이전트가 에셋, 씬, GameObject, 스크립트, 패키지, 에디터 상태를 조작하고 프로파일링 쿼리를 실행하는 데 호출할 수 있는 "MCP 도구"(70개 이상의 내장 명령) 세트를 노출합니다.

주요 기능

• 에디터 측 AI – Unity 창에서 직접 LLM에게 객체 생성, 스크립트 작성, 테스트 실행 또는 문제 디버깅을 요청합니다.
• 런타임 AI – 컴파일된 게임 내부에서 동일한 LLM 호출을 수행하여 동적 NPC 동작 또는 게임 내 디버깅을 가능하게 합니다.
• 공급업체에 구애받지 않는 에이전트 – Anthropic, OpenAI, Microsoft 및 MCP 프로토콜을 지원하는 모든 공급업체와 작동합니다. 잠금 없음.
• 확장 가능한 도구 시스템 – 개발자는 C#으로 사용자 정의 도구나 프롬프트를 추가하고 AI에 노출할 수 있습니다.
• 자동 스킬 생성 – 플러그인은 프로젝트(Unity 버전, 설치된 패키지, OS)를 스캔하고 수동 구성 없이 AI가 사용할 수 있는 "스킬 세트"를 구축합니다.
• 다중 배포 모드 – MCP 서버는 stdio를 통해 로컬에서, HTTP를 통해, 또는 Docker 컨테이너에서 실행할 수 있습니다.

시작 방법

1. 플러그인 설치 – Releases 페이지에서 AI-Game-Dev-Installer.unitypackage를 다운로드하거나 CLI를 실행합니다:

   npm install -g unity-mcp-cli
   unity-mcp-cli install-plugin ./MyUnityProject
   

2. AI 에이전트 선택 – Claude, Codex, Cursor, Copilot, Gemini 등 (UI에 지원되는 에이전트가 나열됩니다).
3. 에이전트 구성 – Unity에서 Window → AI Game Developer를 열고 Auto-generate skills를 클릭하거나 CLI 명령 unity-mcp-cli setup-skills claude-code ./MyUnityProject를 실행합니다.
4. AI와 대화 – "Create three cubes in a circle with radius 2" 와 같은 자연어 명령을 입력하고 에디터가 해당 MCP 도구를 실행하는 것을 확인합니다.

일반적인 워크플로 예시

• 프리팹을 생성하고 배치하고, 컴포넌트 필드를 수정하거나, 즉석에서 새 스크립트를 만듭니다.
• Unity Play-Mode 또는 Edit-Mode 테스트를 자동으로 실행하고 실패 요약을 얻습니다.
• 시각적 디버깅을 위해 씬 또는 카메라의 스크린샷을 캡처합니다.
• 리플렉션 기반 호출을 사용하여 AI에서 모든 C# 메서드(비공개 메서드 포함)를 호출합니다.
• Docker화된 MCP 서버를 배포하고 원격 LLM이 출시된 게임에서 NPC 대화를 구동하도록 합니다.

생태계 및 확장 핵심 패키지는 특정 Unity 하위 시스템에 대한 도구를 추가하는 선택적 스킬 팩으로 확장할 수 있습니다:

• AI Animation, AI Cinemachine, AI InputSystem, AI Navigation, AI ParticleSystem, AI ProBuilder, AI Splines, AI Terrain, AI Tilemap, AI Timeline. 각 팩은 자체 리포지토리(예: Unity-AI-Animation)에 있으며 Unity Package Manager를 통해 설치할 수 있습니다.

설치 옵션

• Unity Package Manager – openupm add com.ivanmurzak.unity.mcp
• CLI – unity-mcp-cli install-plugin …
• Docker 이미지 – aigamedeveloper/mcp-server 헤드리스 서버 배포용.

라이선스 – 이 리포지토리는 MIT 라이선스로 배포됩니다.

사용 대상

• 보일러플레이트 코드를 작성하지 않고 빠른 프로토타이핑을 원하는 인디 개발자.
• LLM 기반 NPC 또는 디버깅 도구를 출시된 게임에 직접 포함하려는 팀.
• Unity에서 AI 지원 게임 개발을 시연하는 교육자.

---

모든 세부 사항은 프로젝트의 README에서 가져왔습니다. 추가 기능은 추론되지 않았습니다.