프로젝트 소개

Unity MCP(또한 "AI Game Developer"로 브랜딩됨)는 Model Context Protocol(MCP)을 통해 AI 에이전트를 Unity 엔진에 연결하는 오픈소스 플러그인입니다. Unity Editor와 컴파일된 게임 런타임을 모두 대상으로 하며, AI 어시스턴트가 워크플로우를 자동화하고 코드를 생성하며 게임 내 동작을 구동할 수 있게 합니다. README에 설명된 주요 기능: - AI 에이전트: Anthropic, OpenAI, Microsoft 등의 에이전트와 호환되며 공급업체 종속이 없습니다. 나열된 클라이언트에는 Claude Code, Claude Desktop, GitHub Copilot, Cursor, Windsurf, Gemini, Antigravity, VS Code, Rider, Visual Studio, Open Code, Cline 및 Kilo Code가 포함됩니다. - 도구: 70개 이상의 내장 MCP 도구를 네 가지 범주로 제공합니다: 프로젝트 및 에셋(에셋 복사/찾기/수정, 프리팹 처리, 패키지 관리), 씬 및 계층 구조(GameObject 및 컴포넌트 생성/수정/삭제, 씬 관리, 스크린샷), 스크립팅 및 편집기(스크립트 읽기/업데이트/실행, 리플렉션 메서드 호출, 테스트 실행, 콘솔 로그, 편집기 상태), 프로파일링 및 진단(프로파일러 시작/중지, 프레임 캡처, 메모리 및 렌더링 통계). - 스킬: 운영 체제, Unity 버전 및 설치된 프로젝트 플러그인을 기반으로 AI 스킬을 생성합니다. - 코드 및 테스트: AI 에이전트를 통해 게임 메커니즘 개발 및 EditMode/PlayMode 테스트 실행을 지원합니다. - 런타임(게임 내): LLM이 컴파일된 게임 내에서 실행되어 동적 NPC 동작 또는 디버깅을 가능하게 하며, README는 이를 다른 도구와의 차별점으로 강조합니다. - 확장성: 모든 C# 메서드는 한 줄로 도구로 노출될 수 있으며, 사용자 지정 MCP 프롬프트도 지원됩니다. - 배포: stdio를 통한 로컬 및 HTTP를 통한 원격으로 작동하며, Docker 이미지 및 바이너리 실행 파일 옵션을 제공합니다. 설치 경로에는 다운로드 가능한 .unitypackage 설치 프로그램, OpenUPM 패키지(com.ivanmurzak.unity.mcp), npm을 통해 설치 가능한 CLI 도구(unity-mcp-cli)가 포함되며, 이 CLI는 Unity 설치, 프로젝트 생성, 플러그인 설치, OAuth 디바이스 흐름을 통한 로그인, 프로젝트 열기를 수행할 수 있습니다. 구성은 Unity의 Window/AI Game Developer 메뉴를 통해 이루어지며, 자동 스킬 생성 또는 MCP 구성과 지원되지 않는 클라이언트를 위한 수동 JSON 구성이 제공됩니다. 추가 확장 패키지는 Animation, Cinemachine, InputSystem, Navigation, ParticleSystem, ProBuilder, Splines, Terrain, Tilemap 및 Timeline용 도구를 제공합니다. 프로젝트는 Unity 프로젝트 경로에 공백이 포함될 수 없다는 요구 사항을 명시합니다. 문서는 기본 MCP 도구, 서버 설정, Docker 배포, 개발 가이드 및 위키를 다룹니다.