Unity MCP Server

Unity MCP Server とは？

Unity MCP Server（MCP for Unity）は、無料で MIT ライセンスの unity mcp ブリッジです。Claude、Cursor、VS Code、Codex などの AI アシスタントから Unity Editor を操作し、アセット管理、シーン構築、C# スクリプト編集、テスト実行を行えます。

プロジェクトは CoplayDev がメンテナンスし、Aura がスポンサーです。元は justinpbarnett/unity-mcp で、現在は CoplayDev/unity-mcp にリダイレクトされます。コミュニティプロジェクトであり、Unity Technologies とは関係ありません。README には 50 個の MCP ツールエントリポイントがあると書かれており、どの MCP クライアントでも使えます。

Unity MCP Server の使い方

前提条件： Unity 2021.3 LTS〜6.x、Python 3.10+ と uv、PATH 上の git（Git URL でインストールする場合）、MCP クライアント。コアツールに API キーは不要です。

1. Unity パッケージをインストールします。 Unity で Window → Package Manager を開き、+ から「Add package from git URL...」を選んで、次を貼り付けます。

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

OpenUPM または Unity Asset Store からもインストールできます。

openupm add com.coplaydev.unity-mcp

2. セットアップウィザードを実行します。 インポート後にウィザードが開き、Python と uv を確認したうえで、検出した MCP クライアントを一覧表示します。使うクライアントを選んで Configure Selected をクリックします。後から Window → MCP for Unity → Configure All Detected Clients で設定し直すこともでき、何度実行しても問題ありません。
3. プロンプトを送ります。 例：「Create a cube at the origin and add a Rigidbody.」。すべて接続されると、ステータスパネルに Connected と表示されます。

unity mcp server はデフォルトで localhost:8080 の HTTP で動作します。stdio も使えます。

Claude Code

Claude Code は HTTP で自動設定されます。手動で追加する場合は次のとおりです。

claude mcp add --transport http UnityMCP http://localhost:8080/mcp

MCP for Unity ウィンドウで HTTP と stdio を切り替えたら、Claude Code を再起動してください。

Claude Desktop

Claude Desktop は stdio のみ対応です。HTTP を選択していても、設定ツールは自動的に stdio を使います。macOS / Linux の手動設定：

{
  "mcpServers": {
    "unityMCP": {
      "command": "uvx",
      "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]
    }
  }
}

Windows では、command に uvx.exe のフルパスを指定します（例：C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Links/uvx.exe）。

Cursor

自動設定で設定項目が書き込まれます。その後、Cursor Settings → MCP で unityMCP サーバーを有効にしてください。手動設定：

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

VS Code

VS Code では mcpServers ではなく servers を使います。

{
  "servers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Codex と Windsurf

どちらもプロジェクトのクライアント対応表に HTTP クライアントとして載っています。設定ツールを実行すると自動で接続されます。

Unity MCP Server の主な機能

• 自然言語で Unity Editor を操作：シーン、GameObject、コンポーネント、プレハブ、マテリアル、アセット
• C# スクリプトの作成と編集（Roslyn によるスクリプト検証も利用可能）
• チャットからテスト実行、プロファイリング、プレイヤービルド
• ツールグループ（core、animation、ui、vfx、testing、probuilder、profiling、docs、asset_gen など）。デフォルトでは core だけが有効なので、プロンプトが小さく保たれます
• Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Codex、Gemini CLI などをワンクリックで設定
• 複数の Unity Editor インスタンス間のルーティングと、認証付きのリモートホスト型サーバー
• Unity 2021.3 LTS〜6.x に対応、無料、MIT ライセンス

Unity MCP Server のツール

• シーンとオブジェクト（core）： manage_scene、manage_gameobject、find_gameobjects、manage_components、manage_prefabs、manage_camera、manage_physics、manage_material で、シーンの中身を作成・編集します。
• スクリプト（core）： create_script、apply_text_edits、script_apply_edits、validate_script、find_in_file、delete_script で、モデルが C# コードを安全に書いたり修正したりできます。
• エディターとプロジェクト（core）： manage_editor、manage_asset、manage_packages、manage_build、execute_menu_item、read_console、refresh_unity、そして複数のコマンドを 1 回の呼び出しで実行する batch_execute。
• オプショングループ： run_tests と get_test_job（testing）、manage_shader と manage_vfx（vfx）、manage_ui、manage_animation、manage_profiler、manage_probuilder、そして generate_model や generate_image などの asset_gen ツール。これらには自分のプロバイダーキーが必要です。
• メタツール： manage_tools でセッションごとにグループをオン・オフできます（例：manage_tools(action="activate", group="vfx")）。set_active_instance で操作対象の Editor を選びます。

Unity MCP Server のユースケース

• 説明するだけでレベルを組む：「Create a red, blue, and yellow cube in the current scene.」
• ゲームプレイのプロトタイプ：「Build a simple player controller with WASD movement and a double-jump.」
• コードの監査：「List every script in Assets/Scripts and tell me which ones reference Rigidbody.」
• エラー修正の高速化：アシスタントにコンソールを読ませ、スクリプトを直して Unity をリフレッシュさせる。
• testing グループを有効にして、1 つの会話でテストを実行し、失敗を修正する。
• IDE を離れずにビルドプラットフォームを切り替えたり、ビルドを開始したりする。

Unity MCP Server と代替ツールの比較

• Unity 公式の MCP サーバー： Unity は Unity AI beta の AI Assistant パッケージに独自の MCP サーバーを同梱しています。Unity 6 以降、Unity Cloud に接続されたプロジェクト、Unity AI ツールのトライアルまたはサブスクリプションが必要です（Unity ブログ）。MCP for Unity は無料のオープンソースで、古い LTS バージョンにも対応しています。
• 他のエンジン： Godot なら Godot MCP Server、3D アセット制作なら Blender MCP Server を参照してください。MCP for Unity の blender_bridge ツールは、BlenderMCP アドオンを入れて起動中の Blender と連携できます。

Unity MCP Server のトラブルシューティング

• Package Manager に「Error when executing git command」と表示される： Git URL でのインストールには PATH 上の git が必要です。Git をインストールするか、OpenUPM または Asset Store を使ってください。
• サーバーが起動しない： ターミナルで uv --version が動くか確認し、MCP for Unity のログを見てください。
• クライアントが接続できない： HTTP サーバーが localhost:8080 で動いていて、クライアント設定の URL と一致しているか確認してください。Cursor では MCP 設定でサーバーを有効にする必要もあります。8080 番ポートは他のサービス（Tailscale など）と衝突することがあり、ポートは MCP for Unity の設定で変更できます。
• macOS で「Claude Not Found」と出る： Finder や Hub から起動した Unity はシェルの PATH を引き継がないことがあります。ターミナルから Hub を起動するか、MCP for Unity ウィンドウの「Choose Claude Install Location」を使ってください。
• Unity 6.3+ と Unity AI Assistant パッケージの併用で System.Collections.Immutable が衝突する： プロジェクトのドキュメントでは、System.Collections.Immutable v9.0.0 を DLL として Assets/Plugins/ に入れる方法が案内されています。