/ 디렉터리 / 플레이그라운드 / Unity-MCP
● 커뮤니티 IvanMurzak ⚡ 바로 사용

Unity-MCP

제작: IvanMurzak · IvanMurzak/Unity-MCP

Unity용 완전한 AI 개발-테스트 루프로, 100개 이상의 툴, Roslyn 기반 C# 실행, 빠른 설정을 위한 CLI를 제공합니다.

IvanMurzak/Unity-MCP는 Unity 플러그인과 MCP 서버로, 광범위한 기능(장면, GameObjects, 컴포넌트, 프리팹, 머티리얼, 패키지, 스크린샷, 테스트, Roslyn C# 실행)을 모든 MCP 클라이언트에 노출합니다. 토큰 효율성과 기본 툴 위의 AI 스킬 계층을 강조합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

unity-2.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "unity-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "unity-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/IvanMurzak/Unity-MCP"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add unity-2 -- TODO 'See README: https://github.com/IvanMurzak/Unity-MCP'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Unity-MCP

단일 프롬프트로 가져온 자산을 일괄 처리하는 방법

👤 Unity 기술 아티스트 ⏱ ~25 min intermediate

언제 쓸까: 200개의 새로운 텍스처가 있고 일관된 가져오기 설정, 밉맵 및 아틀라스 배치를 원할 때입니다.

사전 조건
  • Unity 프로젝트가 열려 있고 플러그인이 설치됨 — unity-mcp-cli install-plugin ./MyUnityProject를 실행하거나 .unitypackage를 가져옵니다
  • MCP 클라이언트가 구성됨 — Claude Desktop 또는 Cursor를 CLI에서 출력한 로컬 MCP 서버를 가리키도록 설정합니다
흐름
  1. 현재 설정 감시
    Assets/Textures/UI의 모든 텍스처를 나열하세요. 사용된 값으로 그룹화한 현재 TextureImporter 설정을 표시하세요.✓ 복사됨
    → 설정별로 그룹화됨 — 대부분 일관되고 이상치가 표시됨
  2. 정책 적용
    모든 항목에 대해 compression=HighQuality, filter=Bilinear, mipmaps=false로 설정하세요. 다시 가져오세요.✓ 복사됨
    → 진행 로그 + 최종 일관된 상태
  3. 시각적으로 검증
    기본 카메라에서 Scene MainMenu의 스크린샷을 찍으세요 — 아무것도 깨지지 않았는지 확인하세요.✓ 복사됨
    → 스크린샷 반환됨, 건전성 검사 통과

결과: 폴더 전체의 일관된 가져오기 설정 + 스크린샷 흔적.

함정
  • 다시 가져오기가 에디터 도메인 리로드를 차단함 — 먼저 장면을 저장하세요; 다시 가져오기가 완료될 때까지 무관한 명령을 실행하지 마세요
함께 쓰기: filesystem

스크립트를 작성하지 않고 에디터에서 일회용 C# 스니펫을 실행하는 방법

👤 일회용 정리를 수행하는 Unity 개발자 ⏱ ~15 min advanced

언제 쓸까: 모든 프리팹을 반복하고 깨진 참조를 수정하고 싶을 때입니다 — 한 번.

흐름
  1. 스니펫 설명
    Roslyn을 통해 C#을 실행하세요: Assets/Prefabs 아래의 모든 프리팹을 반복하고, MissingScript 컴포넌트를 찾으세요, 프리팹 + 누락된 스크립트 guid를 나열하세요.✓ 복사됨
    → 잘못된 프리팹의 보고서
  2. 수정 적용
    이제 해당 MissingScript 컴포넌트를 제거하고 각 프리팹을 저장하세요.✓ 복사됨
    → 업데이트된 프리팹 수

결과: 누락된 스크립트 경고가 없는 프로젝트.

함정
  • Roslyn 실행은 완전한 에디터 권한을 가집니다 — 잘못된 스니펫이 프로젝트를 손상시킬 수 있습니다 — 실행하기 전에 git으로 커밋하세요; 실행하기 전에 코드 스니펫을 검토하세요
함께 쓰기: github

스크린샷을 통해 시각적 회귀를 분류하는 방법

👤 QA, 독립 개발자 ⏱ ~10 min beginner

언제 쓸까: 테스터가 '메뉴가 잘못 보입니다'라고 말하고 기준 이미지를 빠르게 원할 때입니다.

흐름
  1. 의심되는 장면 열기
    MainMenu 장면을 열고 UI 카메라에서 1920x1080으로 스크린샷을 찍으세요.✓ 복사됨
    → 스크린샷 파일 경로 반환됨
  2. 참조와 비교
    여기는 기준 이미지입니다 [첨부]. 차이점을 설명하세요.✓ 복사됨
    → 구체적인 지적사항 (오프셋, 색상, 누락된 요소)

결과: 이미지 증거가 첨부된 버그 보고서.

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

unity-2 + github

채팅에서 리팩토링 + 커밋 + PR 자동화

PlayerController.Speed 필드를 모든 곳에서 MoveSpeed로 이름을 바꾸고, 테스트를 실행하고, 커밋하고 PR을 여세요.✓ 복사됨
unity-2 + filesystem

외부 3D 모델을 프로젝트로 가져옵니다

~/Downloads/kenney/의 모든 .fbx를 Assets/Models/로 이동하고 읽기/쓰기를 비활성화하세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
scene_open path: str 검사 또는 편집 전에 장면을 로드합니다 free
gameobject_find query: str 객체를 찾습니다 free
component_add target, type, values? 컴포넌트를 추가합니다 free
script_create path, body 새 C# 파일을 만듭니다 free
csharp_execute code: str 일회용 에디터 자동화 free
test_run mode: 'Edit'|'Play', filter? 단위/플레이 테스트를 실행합니다 free
screenshot camera?: str, resolution?: {w,h} 시각적 검증 free
console_read since_ms? 변경 후 오류를 확인합니다 free

비용 및 제한

운영 비용

API 쿼터
원격 API 없음 — 모두 로컬
호출당 토큰
장면 목록이 커질 수 있습니다; 필터로 제한하세요
금액
무료, 오픈 소스
전체 계층 덤프보다 좁은 쿼리(gameobject_find 'Enemy*')를 선호하세요.

보안

권한, 시크릿, 파급범위

최소 스코프: 프로젝트에 대한 로컬 파일 시스템 쓰기
자격 증명 저장: 없음 — localhost만
데이터 외부 송신: Localhost. LLM 제공자가 툴이 반환하는 모든 장면/스크립트 콘텐츠를 수신합니다.
절대 부여 금지: MCP HTTP 포트를 비 루프백 인터페이스에 노출하지 마세���

문제 해결

자주 발생하는 오류와 해결

프로젝트 경로에 공백이 포함됨: 툴 실패

프로젝트를 공백이 없는 경로로 이동하세요. 이는 문서화된 제한 사항입니다.

CLI가 Unity를 찾을 수 없음

UNITY_EDITOR_PATH 환경 변수를 에디터 바이너리로 설정하세요.

확인: $UNITY_EDITOR_PATH -version
csharp_execute가 '타입을 찾을 수 없음' 발생

Unity는 실행 전에 성공적으로 컴파일되어야 합니다. 먼저 빨간 콘솔을 수정하고 새로고침하세요.

대안

Unity-MCP 다른 것과 비교

대안언제 쓰나단점/장점
MCP for Unity (CoplayDev)가장 인기 있는 옵션과 광범위한 툴을 원할 때Roslyn 기반 임의의 C# 실행이 없음
mcp-unity (CoderGamester)장면/테스트에 초점을 맞춘 더 간단한 인터페이스고급 툴이 적음

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기