ONEDEV

Unity-MCP

AI Coding ToolsCLIC#

★ 4,247주당 +51조회 3

무엇인가

Unity 프로젝트에 설치되는 MCP 서버 구현체이자 CLI 배포 도구다. 게임 엔진 조작을 사람 손이 아니라 AI 에이전트의 도구 호출로 넘기는 자리에 놓인다. 에디터 전용이 아니라 플레이 모드와 빌드된 게임 실행 중에도 같은 서버가 살아 있다.

어떻게 동작하나

Unity 플러그인이 프로세스 안에서 MCP 서버를 호스팅하고, 기본 도구를 프로젝트·에셋, 씬·하이어라키 등 네 범주로 등록한다. 에셋 복사·이동·삭제, 프리팹 생성·편집, 씬 열기·저장, 게임오브젝트와 컴포넌트의 생성·수정·파괴, 패키지 설치·검색, 카메라 스크린샷 캡처가 도구로 노출된다. 전송은 로컬 stdio와 원격 http 두 방식이며 설정으로 고른다. 스킬은 운영체제, Unity 버전, 프로젝트에 설치된 플러그인을 스캔해 생성한다. 프로젝트 C# 메서드에 한 줄을 붙이면 그 메서드가 도구가 된다.

무엇과 다른가

에디터 스크립트나 외부 브리지 프로세스로 Unity를 원격 조종하는 방식과 달리, 서버가 Unity 프로세스 내부에서 돈다. 그래서 컴파일된 게임 안에서 LLM을 호출해 NPC 행동을 만들거나 실행 중 문제를 디버깅하는 용도가 열린다. 특정 AI 제공자에 묶이지 않고 MCP 클라이언트면 무엇이든 붙는다.

어떻게 쓰나

설치는 `openupm add com.ivanmurzak.unity.mcp` 또는 `.unitypackage` 설치 파일, 혹은 `npx unity-mcp-cli install-plugin ./MyUnityProject`로 한다. 설치 후 Unity 메뉴 `Window/AI Game Developer`에서 Auto-generate skills 또는 Configure MCP를 실행해 클라이언트를 연결한다. CLI로 대신하려면 `npx unity-mcp-cli setup-skills claude-code ./MyUnityProject`를 쓴다.

전제와 한계

Unity 프로젝트와 MCP를 지원하는 AI 클라이언트가 전제다. 런타임 기능을 쓰려면 플러그인이 빌드에 포함되어야 한다. 도구 목록과 스킬 생성 결과는 프로젝트 구성에 따라 달라지며, 기본 도구 전체 목록은 저장소의 `docs/default-mcp-tools.md`에 있다.

관련 논문 2

유사 도구