AnkleBreaker-Studio/unity-mcp-server

해결하는 문제

이 프로젝트는 AI 어시스턴트(클로드, 커서, 윈즈버프 등)와 Unity 게임 엔진 사이의 포괄적인 브리지 역할을 합니다. 개발자들은 AI 채팅 인터페이스를 통해 Unity 에디터와 Unity Hub를 직접 제어할 수 있어, 반복적인 에디터 작업, 씬 설정, 프로젝트 관리 등을 수동으로 수행할 필요가 없습니다.

작동 방식

Model Context Protocol (MCP)를 구현하여 AI 명령을 Unity 내부의 작업으로 변환하는 서버로 작동합니다. 아키텍처는 세 가지 구성 요소로 이루어져 있습니다: AI 어시스턴트, MCP 서버(이 리포지토리), 그리고 HTTP API 브리지를 실행하는 보조 Unity 에디터 플러그인입니다. 서버는 설치 작업을 위해 Unity Hub CLI와 통신하고, 실시간 에디터 조작을 위해 Unity 플러그인과 통신합니다.

대상 사용자

워크플로우 자동화, 씬 빠른 프로토타이핑, 또는 단순한 오브젝트 배치부터 복잡한 쉐이더 및 테라인 편집에 이르기까지 AI를 공동 작업자로 활용하고자 하는 Unity 게임 개발자.

주요 특징

• 거대한 도구 세트: 30개 이상의 카테고리에 걸쳐 330개 이상의 도구를 제공. 씬 관리, 물리, 조명, 애니메이션, 프로파일링 등.
• 심층적 통합: Shader Graph, Amplify Shader Editor, NavMesh 베이킹, Memory Profiler와 같은 고급 Unity 기능을 지원.
• 지능적인 도구 관리: AI 어시스턴트의 컨텍스트 창을 과부하시키지 않기 위해 '코어'와 '고급' 도구의 두 단계 시스템을 사용.
• 강력한 연결성: 멀티 인스턴스 탐지, 포트 내성, 크래시 감지 기능을 통해 에디터 재시작 또는 컴파일 중에도 안정적인 연결을 유지.
• 시각적 피드백: AI가 작업 결과를 시각적으로 검토할 수 있도록 씬 및 게임 뷰의 스크린샷 캡처 기능 제공.