Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Unity Open MCP는 Unity를 위한 광범위한 오픈 소스 Model Context Protocol(MCP) 구현체입니다. 이 도구는 270개 이상의 타입 지정 도구를 제공하며, 안전 게이팅 및 내장 검증 기능을 통해 신뢰성 높은 개발 환경을 지원합니다. 에셋 인텔리전스부터 CI/테스트까지 Unity 프로젝트 전반의 자동화에 활용됩니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Unity Open MCP는 Unity를 위한 가장 광범위한 오픈 소스 MCP(Model Context Protocol) 구현체 중 하나이며,
생산 환경 지향의 자동화 스택 내에서 270개 이상의 타입 지정 도구를 제공합니다. 안전 게이팅된 변형(Safety-gated mutations), 내장 검증(built-in validation), 그리고 실시간(live), 헤드리스(headless), 오프라인 실행 지원을 통해 에셋 인텔리전스 및 에디터 작성부터 클로즈 루프 게임 테스트, 진단(diagnostics), CI(Continuous Integration) 및 패키지 게이팅된 Unity 도메인에 이르기까지 실제 프로젝트에서 신뢰할 수 있는 작업을 수행할 수 있도록 돕습니다.
GameObjects, scenes, prefabs, materials, packages 및 NavMesh, Input System, Cinemachine, Timeline, Shader Graph와 같은 패키지 게이팅된 도메인을 편집할 수 있습니다.
변형(Mutations)은 회귀 검사(regression checks)와 목표 수정(targeted fixes)을 수행하며 checkpoint → mutate → validate → delta 순서로 실행됩니다.
사용자: 그 프리팹을 제거해 주세요.<br>
에이전트: 게이트 미리보기에서Level1과SpawnPoint의 누락된 참조를 발견했으므로, 깨진 프로젝트를 커밋하기 전에 작업을 중단했습니다.
에이전트는 실행 중인 게임을 플레이하고, 사람이 검토할 수 있는 보고서를 전달합니다. 이 기능은 게임을 특정 해상도 또는 장치 시뮬레이터(Device Simulator)에 배치하고, 화면(uGUI 텍스트, 가시성, 레이아웃 진단 등)을 읽으며, 온스크린 라벨을 통해 컨트롤을 터치하거나 클릭, 드래그, 스와이프하는 등의 동작을 수행합니다. 또한 실제 프레임 위에서 여러 초에 걸친 제스처를 플레이하며(레거시 Input Manager 및 Input System 프로젝트 모두 해당), 게임이 특정 상태(로그 라인, 라벨, 오브젝트 또는 프로젝트 자체의 프리디케이트)에 도달할 때까지 기다리며, 이 과정은 선택적으로 빠르게 감기(fast-forwarded)가 가능합니다. 캡처된 이미지는 장치의 네이티브 해상도와 안전 영역을 따르거나, 애니메이션 콘텐츠를 위한 프레임 스케줄링 시리즈로 제공됩니다. 플레이어의 저장 데이터(PlayerPrefs 및 persistentDataPath)는 스냅샷 처리되어 복원되므로, 세션이 개발자의 진행 상황을 소모하지 않으며, 전체 실행 과정(단계별 동작, 판정 결과, 프레임, 그리고 각 단계가 유발한 콘솔 오류)은 Markdown 보고서로 기록됩니다.
사용자: iPhone 13에서 상점 스모크 테스트를 수행해 주세요.<br>
에이전트: 5단계 통과; '구매(Buy)' 버튼을 누르자NullReferenceException오류가 발생했습니다.
보고서에는 프레임과 스택 트레이스가 포함되어 있습니다. 사용자의 저장 데이터는 손상되지 않았습니다.
플레이 테스트 가이드와 플레이 테스트 도구를 참조하세요.
에디트/플레이 모드(Edit/Play Mode) 테스트를 실행하고, 콘솔을 검사하며, 스크린샷, 프로파일러 및 메모리 데이터를 캡처하고, 이벤트를 추출합니다. 이는 에이전트가 자신의 변경 사항을 신뢰하는 데 필요한 피드백입니다.
실시간 에디터(live Editor) 사용을 선호하며, 지원되는 도구의 경우 정확한 버전의 헤드리스 에디터(headless Editor)로 대체할 수 있습니다. 또한 Unity가 종료된 상태에서도 디스크에서 에셋이나 진단 데이터를 읽거나 컴파일할 수 있습니다. 구조화된 검색, 재직렬화(reserialization), 참조/종속성 분석은 해당 경로가 지원하는 경우 계속 사용할 수 있습니다.
Unity 프로젝트는 MCP 서버 릴리스 없이도 타입이 지정되고 검색 가능한 명령어들을 노출할 수 있습니다. 명시적으로 비동기(async) 작업은 진행률, 멱등성(idempotency), 유지되는 결과(retained results), 그리고 정확한 취소(truthful cancellation)가 적용된 관찰 가능한 작업(observable jobs)으로 실행됩니다. CLI와 CI 흐름은 건강 검사(health checks)를 추가하고, 기준선(baselines)을 확인하며, 회귀 게이트(regression gates)를 구현합니다.
세션은 core와 gate-and-verify로 시작하며, 항상 보이는 메타 도구 세트가 추가됩니다. Shader Graph, VFX Graph, Memory Profiler 그룹은 해당 패키지가 감지되면 자동으로 활성화되며, 다른 모든 영역은 필요할 때마다(on demand) 활성화됩니다. 런타임 기능은 정확한 스키마, 경로 및 가용성을 제공하며, 프로젝트 기술(project skills)은 에이전트에게 mutate → gate → fix 루프를 학습시킵니다.
하나의 명령어로 일치하는 패키지 핀(package pins), MCP 구성, 그리고 에이전트 스킬을 설치합니다. 팀 및 모노레포(monorepo) 레이아웃은 커밋 가능하고 기계 독립적인 구성을 기본값으로 합니다. 조정된 업데이트 흐름은 MCP 서버, Unity 패키지, 그리고 선택적 Unity Hub Pro 데스크톱 앱을 포괄합니다.
추가 예시 프롬프트: docs/api/mcp-tools.md.
전체 카탈로그 및 계약: docs/api/mcp-tools.md.
MCP 서버를 위해 Unity 2022.3 LTS 이상과 **Node.js 18+**가 필요합니다.
CLI — 권장: Unity 프로젝트에서 터미널을 열고 다음 명령어를 실행하세요:
npx -y unity-open-mcp@latest setup --client cursor
모노레포(monorepo) 환경에서는 저장소 루트에서 실행하고 Unity 폴더 이름을 지정합니다:
setup --client cursor --unity-subpath Client. 다른 지원되는 작성기(writer)로는 claude, zcode, vscode, codex, opencode, 또는 agents를 사용할 수 있습니다. 이 명령어는 일치하는 핀(pin), 프로젝트 설정, 그리고 번들된 스킬을 설치합니다. 저장소 루트에서 실행하면 팀이 커밋할 수 있는 머신 경로가 없는 설정을 작성합니다 — Portable MCP config를 참조하세요.
2. Unity Hub Pro: Wizard setup의 그래픽 흐름을 사용합니다.
3. 수동(Manual): Manual setup으로 Unity 패키지를 추가한 다음, MCP client configuration에서 클라이언트 항목을 설정합니다.
4. 로컬 체크아웃(Local checkout): Development setup으로 저장소를 빌드하고 실행합니다.
5. 실험적 기능 — AI 에이전트(AI agent): 아래 프롬프트를 AI 클라이언트에 붙여넣습니다.
Install Unity Open MCP in this Unity project by following
exactly (fetch it fresh; do not improvise from memory).
...
전체 절차: Agent setup.
팀 및 모노레포(monorepo)의 경우, 개발자별 절대 경로가 필요 없는 portable MCP configuration을 사용합니다.
사용자를 위한:
기여자를 위한:
다른 MCP 옵션을 보고 싶으신가요? Unity용 MCP 도구 비교를 확인하세요. 여기에는 Unity Open MCP와 해당 분야의 다른 MCP 도구/AI 어시스턴트들의 나란히 배치된 기능 매트릭스가 포함되어 있습니다.
라이선스: MIT — LICENSE를 참조하세요.