MCP Unityは、Unityエディター向けのモデルコンテキストプロトコル（MCP）の実装であり、AIアシスタントがUnityプロジェクトと連携できるようにします。このパッケージは、UnityとMCPプロトコルを実装したNode.jsサーバー間のブリッジを提供し、Claude、Windsurf、CursorなどのAIエージェントがUnityエディター内で操作を実行できるようにします。
MCP Unityは、Unity Library/PackedCacheフォルダをワークスペースに追加することで、VSCode系IDE（Visual Studio Code、Cursor、Windsurf）との自動統合を実現します。この機能は以下のとおりです。
MCP を介して Unity シーンと GameObject を操作およびクエリするには、次のツールを使用できます。
execute_menu_item : Unity メニュー項目 (MenuItem 属性でタグ付けされた関数) を実行します。プロンプトの例: 「新しい空のゲームオブジェクトを作成するには、メニュー項目「GameObject/Create Empty」を実行します。」
select_gameobject : パスまたはインスタンスIDでUnity階層内のゲームオブジェクトを選択します。プロンプトの例: 「シーン内のメインカメラオブジェクトを選択してください」
update_gameobject : ゲームオブジェクトのコアプロパティ (名前、タグ、レイヤー、アクティブ/静的状態) を更新するか、ゲームオブジェクトが存在しない場合は作成します。プロンプトの例: 「Player オブジェクトのタグを 'Enemy' に設定し、非アクティブにします」
update_component : GameObjectのコンポーネントフィールドを更新するか、コンポーネントが含まれていない場合はGameObjectに追加します。例のプロンプト: 「Player オブジェクトに Rigidbody コンポーネントを追加し、その質量を 5 に設定します」
add_package : Unity パッケージマネージャーに新しいパッケージをインストールしますプロンプトの例: 「TextMeshPro パッケージをプロジェクトに追加する」
run_tests : Unity Test Runnerを使用してテストを実行しますプロンプトの例: 「プロジェクト内のすべての EditMode テストを実行します」
send_console_log : コンソールログをUnityに送信するプロンプトの例: 「コンソールログを Unity エディターに送信する」
add_asset_to_scene : AssetDatabase から Unity シーンにアセットを追加しますプロンプトの例: 「プロジェクトから現在のシーンに Player プレハブを追加します」
unity://menu-items : Unity エディターで利用可能なすべてのメニュー項目のリストを取得し、 execute_menu_itemツールを実行します。プロンプトの例: 「GameObject の作成に関連する利用可能なすべてのメニュー項目を表示します」
unity://scenes-hierarchy : 現在のUnityシーン階層内のすべてのゲームオブジェクトのリストを取得しますプロンプトの例: 「現在のシーンの階層構造を表示してください」
unity://gameobject/{id} : インスタンスIDまたはシーン階層内のオブジェクトパスによって特定のゲームオブジェクトの詳細情報を取得します。これには、シリアル化されたプロパティとフィールドを持つすべてのゲームオブジェクトのコンポーネントが含まれます。プロンプトの例: 「Player GameObject の詳細情報を取得してください」
unity://logs : Unityコンソールからすべてのログのリストを取得しますプロンプトの例: 「Unity コンソールからの最近のエラー メッセージを表示してください」
unity://packages : Unity パッケージマネージャーからインストール済みおよび利用可能なパッケージに関する情報を取得します。プロンプトの例: 「Unity プロジェクトに現在インストールされているすべてのパッケージを一覧表示する」
unity://assets : Unity Asset Database内のアセットに関する情報を取得しますプロンプトの例: 「プロジェクト内のすべてのテクスチャアセットを検索する」
unity://tests/{testMode} : Unity Test Runner 内のテストに関する情報を取得します。プロンプトの例: 「Unity プロジェクトで利用可能なすべてのテストを一覧表示する」
この MCP Unity サーバーのインストールは、複数のステップから成るプロセスです。
https://github.com/CoderGamester/mcp-unity.gitMCP Unity サーバーを実行するには、コンピューターに Node.js 18 以降がインストールされている必要があります。
AI クライアントの MCP 構成ファイル (例: Claude Desktop の claude_desktop_config.json) を開き、次のテキストをコピーします。
ABSOLUTE/PATH/TOMCP Unity インストールへの絶対パスに置き換えるか、Unity エディターの MCP サーバー ウィンドウ ([ツール] > [MCP Unity] > [サーバー ウィンドウ]) からテキストをコピーします。
AIクライアントがWebSocketサーバーに接続すると、ウィンドウの緑色のボックスに自動的に表示されます。
デフォルトでは、WebSocket サーバーはポート 8090 で実行されます。このポートは 2 つの方法で変更できます。
デフォルトでは、MCPサーバーとWebSocket間のタイムアウトは10秒です。使用しているOSに応じて変更できます。
Windows 以外の OS の場合は、次の 2 か所を設定する必要があります。
[！ヒント]
AI コーディング IDE (例: Claude Desktop、Cursor IDE、Windsurf IDE) と MCP サーバー間のタイムアウトは、IDE によって異なります。
MCP UnityサーバーはNode.jsを使用して構築されています。 buildディレクトリでTypeScriptコードをJavaScriptにコンパイルする必要があります。サーバーをビルドするには、ターミナルを開き、以下のコマンドを実行してください。
@modelcontextprotocol/inspectorを使用してサーバーをデバッグします。
ターミナルを閉じる前、またはMCP Inspectorでデバッグする前に、必ずCtrl + Cでサーバーをシャットダウンしてください。
run_testsツールは次の応答を返します。
このエラーは、プレイ モードに切り替えてドメインを再読み込みするとブリッジ接続が失われるため発生します。
回避策としては、編集 > プロジェクト設定 > エディター > 「再生モード設定に入る」でドメインの再ロードをオフにします。
ご質問がある場合やサポートが必要な場合は、このリポジトリで問題を報告してください。
他に連絡できる方法:
貢献を歓迎します！お気軽にプルリクエストを送信したり、リクエストを添えて Issue を開いてください。
Conventional Commits形式に従って変更をコミットします。
このプロジェクトはMITライセンスの下にあります
local-only server
The server can only run on the client's local machine because it depends on local resources.
MCP Unity サーバーは、Unity エディター ゲーム エンジンをさまざまな AI モデル クライアント (Claude Desktop、Windsurf、Cursor など) と統合します。
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/CoderGamester/mcp-unity'
If you have feedback or need assistance with the MCP directory API, please join our Discord server