dev.breadpack.UnityMcpBridge 0.3.0

Unity MCP

Unity MCP (Model Context Protocol) Bridge — Connect AI agents to Unity Editor.

Architecture

AI Agent (Claude, Cursor, etc.)
    ↕ stdio (MCP protocol)
UnityMcpBridge (.NET)
    ↕ TCP (binary protocol)
Unity Editor (UnityMcpEditor package)

Two components are required:

Claude Code 플러그인으로 설치 (권장)

Claude Code에서 한 줄로 설치:

/plugin install --from github:breadpack/UnityMcp

또는 프로젝트 .claude/settings.json에 등록:

{
  "enabledPlugins": {
    "unity-mcp": {
      "source": {
        "source": "github",
        "repo": "breadpack/UnityMcp"
      }
    }
  }
}

설치 시 포트, 자동 저장, 컴파일/리로드 체크 등의 옵션을 프롬프트로 설정할 수 있다.

포함 내용:

• MCP 서버 (unity-bridge) — 45+ Unity 도구
• Skills 6개 — 워크플로우 가이드
• Agents 3개 — unity-scene-architect, unity-debugger, unity-asset-manager
• Hooks — 컴파일/도메인 리로드 자동 감지 및 대기

Quick Start

Step 1. Install MCP Bridge

No pre-install needed — just configure and go (see Step 3).

Or install globally:

# npx (recommended, no .NET required)
npx -y unity-mcp-bridge

# dotnet tool (requires .NET 9.0+ SDK)
dotnet tool install -g dev.breadpack.UnityMcpBridge

Step 2. Install Unity Editor Package

Requires Unity 6000.0+ (Unity 6)

Open Unity Editor > Window > Package Manager > + > Add package from git URL:

https://github.com/breadpack/UnityMcp.git?path=UnityMcpEditor

Newtonsoft.Json (com.unity.nuget.newtonsoft-json) is auto-resolved as a dependency. No other prerequisites required.

Step 3. Configure your AI tool

Add MCP server configuration to your AI tool:

<details> <summary><b>Claude Code</b> (.mcp.json in project root)</summary>

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "unity-mcp-bridge"]
    }
  }
}

Or via CLI:

claude mcp add unity -- npx -y unity-mcp-bridge

</details>

<details> <summary><b>Claude Desktop</b></summary>

Edit %APPDATA%/Claude/claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "unity-mcp-bridge"]
    }
  }
}

</details>

<details> <summary><b>Cursor / VS Code</b> (.cursor/mcp.json or .vscode/mcp.json)</summary>

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "unity-mcp-bridge"]
    }
  }
}

</details>

<details> <summary><b>Using dotnet tool instead</b></summary>

If you installed via dotnet tool install -g, use the command directly:

{
  "mcpServers": {
    "unity": {
      "command": "unity-mcp-bridge"
    }
  }
}

</details>

Step 4. Verify

Open Unity Editor with the package installed, then ask your AI agent:

"Unity에 ping을 보내줘"

Alternative: Clone and Build

If you prefer to build from source:

git clone https://github.com/breadpack/UnityMcp.git
cd UnityMcp/UnityMcpBridge
dotnet run

Configure with:

{
  "mcpServers": {
    "unity": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/UnityMcp/UnityMcpBridge"]
    }
  }
}

Requires .NET 9.0+ SDK

Configuration

Example with custom port:

{
  "mcpServers": {
    "unity": {
      "command": "unity-mcp-bridge",
      "env": { "UNITY_TCP_PORT": "9877" }
    }
  }
}

Claude Code Plugin (Skills 포함)

Claude Code에서 스킬(슬래시 커맨드)과 함께 사용하려면 플러그인으로 설치할 수 있습니다.

Plugin 설치

방법 A: GitHub에서 설치 (권장)

claude plugin install --from https://github.com/breadpack/UnityMcp

방법 B: 로컬 클론 후 설치

git clone https://github.com/breadpack/UnityMcp.git
claude --plugin-dir ./UnityMcp

Plugin 설치 시 MCP 서버 설정(.mcp.json)이 자동으로 적용되므로, Step 3의 수동 설정은 불필요합니다. Unity Editor 패키지(Step 2)는 별도로 설치해야 합니다.

제공 Skills

Plugin을 설치하면 다음 슬래시 커맨드를 사용할 수 있습니다:

Plugin 사용 예시

> /unity-mcp:unity-scene-setup
> 3D 플랫포머 게임의 기본 씬을 구성해줘.
> 바닥(Plane), 플레이어(Capsule+Rigidbody+CapsuleCollider), 카메라를 배치해줘.

> /unity-mcp:unity-debug
> 현재 씬에서 에러가 발생하는 원인을 찾아줘.

Available Tools (35)

Observation (14)

Scene Manipulation (10)

Component & Property (4)

Material (2)

Asset Management (1)

Prefab (1)

Animation (1)

Build & Settings (2)

Conditional Features

Addressables Support

To enable Addressable tools, add the scripting define symbol to your Unity project:

1. Edit > Project Settings > Player > Scripting Define Symbols
2. Add UNITY_MCP_ADDRESSABLES

Update

npx는 자동으로 최신 버전을 사용합니다. dotnet tool을 사용하는 경우:

dotnet tool update -g dev.breadpack.UnityMcpBridge

License

MIT