AnkleBreaker-Studio/unity-mcp-server

해결하는 문제

AnkleBreaker Unity MCP는 AI 어시스턴트를 Unity 게임 엔진에 연결하여 씬 작성, 게임 오브젝트 관리, 테스트 실행 및 빌드 처리를 가능하게 합니다. 여러 Unity 프로젝트와 에디터 전반에서 AI 에이전트를 동시에 조정하는 어려움을 해결하며, 수동 개입 없이도 AI 에이전트가 Unity Editor 및 실행 중인 게임과 상호 작용할 수 있는 구조화된 방법을 제공합니다.

작동 방식

이 프로젝트는 Node.js 서버와 Unity 플러그인으로 구성됩니다. 서버는 Model Context Protocol (MCP)을 구현하여 AI 클라이언트(LLM 기반 어시스턴트 등)와 Unity Editor 사이의 가교 역할을 합니다. 요청 로컬 라우팅(request-local routing)을 사용하여 서로 다른 에이전트가 특정 Unity 프로젝트 인스턴스를 타겟팅할 수 있도록 보장합니다. Unity 플러그인은 에디터 내에서 실제 명령 실행을 담당하며, 쓰기 작업을 직렬화하고 읽기 작업을 배치 처리하는 큐를 관리하여 안정성을 유지합니다.

대상 사용자

AI 에이전트를 활용하여 씬 구성 자동화, 멀티플레이어 시나리오 반복, 프로파일링 수행, 또는 여러 에디터 인스턴스에 걸친 프로젝트 단위 작업을 관리하고자 하는 Unity 개발자 및 테크니컬 아티스트.

주요 특징

• 멀티 프로젝트 조정: 여러 개의 열린 Unity 에디터에 대해 독립적인 요청 라우팅과 개별 큐 관리를 지원합니다.
• 광범위한 툴셋: 80개 이상의 공개된 MCP 도구와 씬 작성, 머티리얼, 프로파일링, Unity Hub 통합을 위한 수백 개의 고급 도구를 제공합니다.
• 멀티플레이어 지원: Multiplayer Play Mode (MPPM) 및 ParrelSync를 위한 전용 도구를 포함하여 호스트/클라이언트 시나리오를 조정합니다.
• 가시성: 에이전트 세션, 요청 큐, 작업 기록을 모니터링하기 위한 Unity 대시보드를 제공하며, 명명된 실행 취소(named undo)를 지원합니다.
• 성능 최적화: 바인딩된 컴파일러 메타데이터 재사용 및 페이지네이션된 테스트 결과를 구현하여 코드 실행 및 데이터 검색의 지연 시간을 줄입니다.