CoderGamester/mcp-unity

해결하는 문제

MCP Unity는 Unity 에디터와 AI 코드 보조 도구 간의 다리 역할을 합니다. AI 에이전트가 Unity 프로젝트에 직접 접근하여 씬을 조작하고, 자산을 관리하며, 에디터 상태를 제어할 수 있게 해줍니다. 개발자가 씬 계층 구조에 대한 코드나 설명을 수동으로 복사-붙여넣기할 필요가 없습니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP)를 구현하며, Node.js 서버가 Unity 에디터와 통신합니다. Cursor, Windsurf, Claude Code와 같은 AI 보조 도구가 Unity 내에서 작업을 실행할 수 있도록 도구와 리소스 세트를 제공합니다. 또한 IDE와의 통합을 위해 Library/PackedCache 폴더를 워크스페이스에 추가하여 Unity 패키지의 코드 인텔리전스를 향상시킵니다.

대상 사용자

AI 기반 IDE나 에이전트를 사용하여 게임 개발 워크플로우를 가속화하고 싶은 Unity 개발자. AI가 GameObject, 컴포넌트, 씬 설정을 직접 관리할 수 있도록 합니다.

주요 기능

• 씬 조작: GameObject 생성, 선택, 이동, 회전, 스케일링, 삭제, 부모 변경, 복제 기능 제공.
• 자산 및 패키지 관리: Unity Package Manager를 통해 패키지 설치 가능, 마테리얼 및 프리팹 생성 및 할당 가능.
• 에디터 제어: Unity 메뉴 항목 실행, Unity Test Runner를 통한 테스트 실행, 콘솔 로그 조회.
• 플레이 모드 제어: Unity의 플레이 모드 시작, 일시정지, 중지, 단계 실행 가능.
• 배치 실행: 한 번의 요청으로 여러 작업을 실행 가능하여 라운드트립을 줄이고 원자적 작업을 지원.
• 문맥 기반 리소스: MCP 리소스를 통해 AI 에이전트가 씬 계층 구조, 메뉴 항목, 자산 데이터베이스에 접근 가능.