Skip to content

Installation

Daisuke Tsukada edited this page Dec 19, 2025 · 1 revision

インストール

UniMCP4CC のインストール手順です。

動作環境

項目 バージョン
Unity 6000.0 以降 (Unity 6)
Node.js 18 以降
AI Client Claude Code

Important: このパッケージは Unity 6 (6000.x) 向けにビルドされています。

Unity Package Manager からインストール

1. パッケージの追加

Unity Editor で:

  1. Window > Package Manager を開く
  2. 左上の + ボタンをクリック
  3. Add package from git URL... を選択
  4. 以下の URL を入力:
https://github.com/dsgarage/UniMCP4CC.git
  1. Add をクリック

2. Claude Code の設定

パッケージのインストールが完了したら:

  1. Window > Unity MCP > Setup Claude Code を開く
  2. 「Setup Claude Code」ボタンをクリック
  3. 自動的に ~/.mcp.json が設定される

3. 動作確認

  1. Unity Editor の Console に以下が表示されることを確認:

    [MCP] HTTP Server started on port 5051
    
  2. Claude Code を起動(または再起動)

  3. Claude Code に Unity について質問してみる:

    「Unity プロジェクトのシーン内容を教えて」
    

手動設定(オプション)

自動設定がうまくいかない場合は、手動で設定できます。

1. MCP Bridge のセットアップ

cd /path/to/your/unity/project/Library/PackageCache/com.dsgarage.unimcp4cc@xxx/Server~/mcp-bridge
npm install

2. Claude Code の設定

~/.mcp.json を編集:

{
  "mcpServers": {
    "unity-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/unity/project/Library/PackageCache/com.dsgarage.unimcp4cc@xxx/Server~/mcp-bridge/index.js"
      ]
    }
  }
}

トラブルシューティング

接続できない

  1. Unity Editor が起動しているか確認
  2. Console で MCP Server の起動を確認
  3. ファイアウォールでポート 5051 が許可されているか確認

npm install が失敗する

Node.js 18 以降がインストールされているか確認:

node --version

Claude Code が Unity を認識しない

  1. Claude Code を完全に終了
  2. ~/.mcp.json のパスが正しいか確認
  3. Claude Code を再起動

アンインストール

  1. Unity Package Manager で パッケージを削除
  2. ~/.mcp.json から unity-mcp エントリを削除

Clone this wiki locally