MCP Unity Editor（ゲームエンジン）

英語	🇨🇳簡体中文	🇯🇵日本語

                              ,/(/.   *(/,                                  
                          */(((((/.   *((((((*.                             
                     .*((((((((((/.   *((((((((((/.                         
                 ./((((((((((((((/    *((((((((((((((/,                     
             ,/(((((((((((((/*.           */(((((((((((((/*.                
            ,%%#((/((((((*                    ,/(((((/(#&@@(                
            ,%%##%%##((((((/*.             ,/((((/(#&@@@@@@(                
            ,%%######%%##((/(((/*.    .*/(((//(%@@@@@@@@@@@(                
            ,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@(                
            ,%%####%(    /#%#%%%##(//(#@@@@@@@%,   #@@@@@@@(                
            ,%%####%(        *#%###%@@@@@@(        #@@@@@@@(                
            ,%%####%(           #%#%@@@@,          #@@@@@@@(                
            ,%%##%%%(           #%#%@@@@,          #@@@@@@@(                
            ,%%%#*              #%#%@@@@,             *%@@@(                
            .,      ,/##*.      #%#%@@@@,     ./&@#*      *`                
                ,/#%#####%%#/,  #%#%@@@@, ,/&@@@@@@@@@&\.                    
                 `*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´                   
                    `*%%###########%@@@@@@@@@@@@@@&*´                        
                        `*%%%######%@@@@@@@@@@&*´                            
                            `*#%%##%@@@@@&*´                                 
                               `*%#%@&*´                                     
                                                        
     ███╗   ███╗ ██████╗██████╗         ██╗   ██╗███╗   ██╗██╗████████╗██╗   ██╗
     ████╗ ████║██╔════╝██╔══██╗        ██║   ██║████╗  ██║██║╚══██╔══╝╚██╗ ██╔╝
     ██╔████╔██║██║     ██████╔╝        ██║   ██║██╔██╗ ██║██║   ██║    ╚████╔╝ 
     ██║╚██╔╝██║██║     ██╔═══╝         ██║   ██║██║╚██╗██║██║   ██║     ╚██╔╝  
     ██║ ╚═╝ ██║╚██████╗██║             ╚██████╔╝██║ ╚████║██║   ██║      ██║   
     ╚═╝     ╚═╝ ╚═════╝╚═╝              ╚═════╝ ╚═╝  ╚═══╝╚═╝   ╚═╝      ╚═╝

MCP Unityは、Unityエディター向けのModel Context Protocolの実装であり、AIアシスタントがUnityプロジェクトと対話できるようにします。このパッケージは、UnityとMCPプロトコルを実装するNode.jsサーバー間のブリッジを提供し、Claude、Windsurf、CursorなどのAIエージェントがUnityエディター内で操作を実行できるようにします。

機能

IDE統合 - パッケージキャッシュアクセス

MCP Unityは、UnityのLibrary/PackedCacheフォルダーをワークスペースに追加することで、VSCode系IDE（Visual Studio Code、Cursor、Windsurf）との自動統合を提供します。この機能により：

Unityパッケージのコードインテリジェンスが向上
Unityパッケージのより良いオートコンプリートと型情報が有効化
AIコーディングアシスタントがプロジェクトの依存関係を理解するのに役立つ

MCPサーバーツール

execute_menu_item: Unityメニュー項目（MenuItem属性でタグ付けされた関数）を実行

例: "新しい空のGameObjectを作成するためにメニュー項目'GameObject/Create Empty'を実行"
select_gameobject: パスまたはインスタンスIDでUnity階層内のゲームオブジェクトを選択

例: "シーン内のMain Cameraオブジェクトを選択"
update_gameobject: GameObject のコアプロパティ（名前、タグ、レイヤー、アクティブ/静的状態）を更新、または存在しない場合は作成します

例: "Playerオブジェクトのタグを ‘Enemy’ に設定し、非アクティブにする"
update_component: GameObject上のコンポーネントフィールドを更新、またはGameObjectに含まれていない場合は追加

例: "PlayerオブジェクトにRigidbodyコンポーネントを追加し、その質量を5に設定"
add_package: Unityパッケージマネージャーに新しいパッケージをインストール

例: "プロジェクトにTextMeshProパッケージを追加"
run_tests: Unityテストランナーを使用してテストを実行

例: "プロジェクト内のすべてのEditModeテストを実行"
send_console_log: Unityにコンソールログを送信

例: "Unity Editorにコンソールログを送信"
add_asset_to_scene: AssetDatabaseからアセットをUnityシーンに追加

例: "プロジェクトからPlayerプレハブを現在のシーンに追加"

MCPサーバーリソース

unity://menu-items: execute_menu_itemツールを容易にするために、Unityエディターで利用可能なすべてのメニュー項目のリストを取得

例: "GameObject作成に関連する利用可能なすべてのメニュー項目を表示"
unity://scenes-hierarchy: 現在のUnityシーン階層内のすべてのゲームオブジェクトのリストを取得

例: "現在のシーン階層構造を表示"
unity://gameobject/{id}: シーン階層内のインスタンスIDまたはオブジェクトパスで特定のGameObjectに関する詳細情報を取得

例: "Player GameObjectに関する詳細情報を取得"
unity://logs: Unityコンソールからのすべてのログのリストを取得

例: "Unityコンソールからの最近のエラーメッセージを表示"
unity://packages: Unityパッケージマネージャーからインストール済みおよび利用可能なパッケージ情報を取得

例: "プロジェクトに現在インストールされているすべてのパッケージをリスト"
unity://assets: Unityアセットデータベース内のアセット情報を取得

例: "プロジェクト内のすべてのテクスチャアセットを検索"
unity://tests/{testMode}: Unityテストランナー内のテスト情報を取得

例: "プロジェクトで利用可能なすべてのテストをリスト"

要件

Unity 2022.3以降 - サーバーをインストールするため
Node.js 18以降 - サーバーを起動するため
npm 9以降 - サーバーをデバッグするため

インストール

Important

プロジェクトパスにスペースを含めることはできません

Unity プロジェクトのファイルパスにスペースを含めないことが非常に重要です。プロジェクトパスにスペースが含まれている場合、MCP クライアント（例：Cursor、Claude、Windsurf）は MCP Unity サーバーに接続できません。

例：

✅ 動作します: C:\Users\YourUser\Documents\UnityProjects\MyAwesomeGame
❌ 失敗します: C:\Users\Your User\Documents\Unity Projects\My Awesome Game

インストールを進める前に、プロジェクトがスペースを含まないパスにあることを確認してください。

このMCP Unityサーバーのインストールは複数ステップのプロセスです：

ステップ1: Node.jsをインストール

MCP Unityサーバーを実行するには、コンピューターにNode.js 18以降がインストールされている必要があります：

Windows

Node.jsダウンロードページにアクセス
LTSバージョンのWindowsインストーラー（.msi）をダウンロード（推奨）
インストーラーを実行し、インストールウィザードに従う
PowerShellを開いて以下を実行してインストールを確認：
```
node --version
```

macOS

Node.jsダウンロードページにアクセス
LTSバージョンのmacOSインストーラー（.pkg）をダウンロード（推奨）
インストーラーを実行し、インストールウィザードに従う
または、Homebrewがインストールされている場合は以下を実行：
```
brew install node@18
```
ターミナルを開いて以下を実行してインストールを確認：
```
node --version
```

ステップ2: Unityパッケージマネージャー経由でUnity MCPサーバーパッケージをインストール

Unityパッケージマネージャーを開く（Window > Package Manager）
左上隅の"+"ボタンをクリック
"Add package from git URL..."を選択
入力: https://github.com/CoderGamester/mcp-unity.git
"Add"をクリック

ステップ3: AI LLMクライアントを設定

オプション1: Unityエディターを使用して設定

Unityエディターを開く
Tools > MCP Unity > Server Windowに移動
以下の画像のようにAI LLMクライアントの"Configure"ボタンをクリック

表示されるポップアップで設定インストールを確認

オプション2: 手動設定

AIクライアントのMCP設定ファイル（例：Claude Desktopのclaude_desktop_config.json）を開き、以下のテキストをコピー：

ABSOLUTE/PATH/TOをMCP Unityインストールの絶対パスに置き換えるか、UnityエディターMCPサーバーウィンドウ（Tools > MCP Unity > Server Window）からテキストをコピー

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}

サーバーの起動

MCP Unityサーバーを起動するには2つの方法があります：

オプション: Node.jsサーバーのインストール

デフォルトでは、Node.jsサーバーは Server~/ ディレクトリにインストールされます。問題が発生した場合は、以下の手順で強制的にインストールできます：

Unityエディターを開く
メニューから Tools > MCP Unity > Server Window に移動
「Force Install Server」ボタンをクリック

Tip

Node.js サーバーは Server~/ ディレクトリにインストールされます。

オプション1: Unityエディター経由で起動

Unityエディターを開く
Tools > MCP Unity > Server Windowに移動
"Start Server"ボタンをクリック
Open Claude Desktop or your AI Coding IDE (e.g. Cursor IDE, Windsurf IDE, etc.) and start executing Unity tools

オプション2: コマンドラインから起動

ターミナルまたはコマンドプロンプトを開く
MCP Unityサーバーディレクトリに移動
以下のコマンドを実行：
```
node Server~/build/index.js
```

オプション: タイムアウト設定

デフォルトでは、MCPサーバーとWebSocket間のタイムアウトは 10 秒です。お使いの環境に応じて以下の手順で変更できます：

Unityエディターを開く
Tools > MCP Unity > Server Window に移動
Request Timeout (seconds) の値を希望のタイムアウト秒数に変更
Unityが環境変数 UNITY_REQUEST_TIMEOUT に新しい値を設定
Node.jsサーバーを再起動
Start Server を再度クリックして再接続

Tip

AIコーディングIDE（Claude Desktop、Cursor IDE、Windsurf IDEなど）とMCPサーバー間のタイムアウトは、使用するIDEによって異なる場合があります。

オプション：リモート MCP ブリッジ接続を許可する

デフォルトでは、WebSocket サーバーは 'localhost' にバインドされています。他のマシンから MCP ブリッジ接続を許可するには、以下の手順に従ってください：

Unity エディターを開く
メニューから「Tools > MCP Unity > Server Window」を選択
「Allow Remote Connections（リモート接続を許可）」チェックボックスを有効にする
Unity は WebSocket サーバーを '0.0.0.0'（すべてのインターフェース）にバインドします
Node.js サーバーを再起動して新しいホスト設定を適用する
リモートで MCP ブリッジを実行する場合は、環境変数 UNITY_HOST を Unity 実行マシンの IP アドレスに設定して起動：
UNITY_HOST=192.168.1.100 node server.js

サポート & フィードバック

ご質問やサポートが必要な場合は、このリポジトリのIssueを開くか、以下までご連絡ください：

LinkedIn:
Discord: gamester7178
Email: game.gamester@gmail.com

貢献

貢献は大歓迎です！プルリクエストを送信するか、Issueを開いてください。

コミットメッセージはConventional Commits形式に従ってください。

ライセンス

本プロジェクトはMIT Licenseの下で提供されます。

謝辞

Model Context Protocol
Unity Technologies
Node.js
WebSocket-Sharp

よくある質問

MCP Unityとは何ですか？

MCP Unityは、Model Context Protocol（MCP）を使用して、Unityエディター環境をAIアシスタントLLMツールに接続する強力なブリッジです。

本質的に、MCP Unityは次のことを行います。

Unityエディターの機能（オブジェクトの作成、コンポーネントの変更、テストの実行など）を、AIが理解して使用できる「ツール」および「リソース」として公開します。
Unity内にWebSocketサーバーを、そしてMCPを実装するNode.jsサーバー（UnityへのWebSocketクライアントとして機能）を実行します。これにより、AIアシスタントはUnityにコマンドを送信し、情報を受け取ることができます。
AIアシスタントとの自然言語プロンプトを使用して、Unityプロジェクト内で複雑なタスクを実行できるようにし、開発ワークフローを大幅に加速します。

MCP Unityを使用する理由は何ですか？

MCP Unityは、開発者、アーティスト、プロジェクトマネージャーにいくつかの魅力的な利点を提供します。

開発の加速: AIプロンプトを使用して、反復的なタスクを自動化し、ボイラープレートコードを生成し、アセットを管理します。これにより、創造的で複雑な問題解決に集中する時間を確保できます。
生産性の向上: メニューを手動でクリックしたり、簡単な操作のためにスクリプトを作成したりすることなく、Unityエディターの機能と対話できます。AIアシスタントは、Unity内でのあなたの能力を直接拡張します。
アクセシビリティの向上: UnityエディターやC#スクリプトの深い複雑さにあまり慣れていないユーザーでも、AIのガイダンスを通じてプロジェクトに意味のある貢献や変更を行うことができます。
シームレスな統合: MCPをサポートするさまざまなAIアシスタントやIDEと連携するように設計されており、開発ツールキット全体でAIを活用する一貫した方法を提供します。
拡張性: プロトコルとツールセットは拡張可能です。プロジェクト固有またはUnityの機能をAIに公開するための新しいツールとリソースを定義できます。
コラボレーションの可能性: AIがチームメンバーが従来行っていたタスクを支援したり、プロジェクトの構造や操作をガイドすることで新しい開発者のオンボーディングを支援したりする新しいコラボレーション方法を促進します。

MCP Unityは、今後登場するUnity 6.2のAI機能と比較してどうですか？

Unity 6.2では、以前のUnity Muse（テクスチャやアニメーション生成などの生成AI機能用）やUnity Sentis（Unityランタイムでニューラルネットワークを実行するため）を含む、新しい組み込みAIツールが導入される予定です。Unity 6.2はまだ完全にリリースされていないため、この比較は公開されている情報と予想される機能に基づいています。

焦点:
- MCP Unity: 主にエディターの自動化と対話に焦点を当てています。これにより、外部AI（LLMベースのコーディングアシスタントなど）がUnityエディター自体を制御およびクエリして、シーン、アセット、プロジェクト設定を操作できます。これは、エディター内での開発者のワークフローを強化することです。
- Unity 6.2 AI:
  - エディター内でのコンテンツ作成（テクスチャ、スプライト、アニメーション、動作、スクリプトの生成）と、Unityエディターインターフェースに直接統合された一般的なタスクのAI支援を目的としています。
  - UnityのドキュメントとAPI構造に関するあらゆる質問に、Unity環境により正確なカスタマイズされた例で答えるための微調整されたモデル。
  - AIモデルの推論を実行する機能を追加し、NPCの動作、画像認識などの機能のために、事前にトレーニングされたニューラルネットワークをゲームまたはアプリケーション内にデプロイして実行できるようにします。
ユースケース:
- MCP Unity: 「新しい3Dオブジェクトを作成し、名前を「Player」にし、Rigidbodyを追加して、質量を10に設定してください。」「すべてのプレイモードテストを実行してください。」「コンソールログのエラーを修正するよう依頼してください。」「カスタムメニュー項目「iOS用のビルドを準備」を実行し、発生する可能性のあるエラーを修正してください。」
- Unity 6.2 AI: 「このマテリアルにSFテクスチャを生成してください。」「シーン内のすべてのツリーの位置を「forest」とタグ付けされたテレインゾーン内に配置するように更新してください。」「このキャラクターのアニメーションを作成してください。」「キャラクターを完成させるために2Dスプライトを生成してください。」「コンソールログのエラーの詳細を尋ねてください。」
補完的であり、相互排他的ではない: MCP UnityとUnityのネイティブAIツールは補完的であると見なすことができます。AIコーディングアシスタントでMCP Unityを使用してシーンを設定したり、アセットを一括変更したりしてから、Unity AIツールを使用して特定のテクスチャを生成したり、アニメーションや2Dスライトをそれらのアセットの1つに作成したりすることができます。MCP Unityは、より広範な外部AIサービスと統合したり、カスタム自動化ワークフローを構築したりしたい開発者にとって強力な、プロトコルベースのエディターとの対話方法を提供します。

現在、どのMCPホストとIDEがMCP Unityをサポートしていますか？

MCP Unityは、MCPクライアントとして機能できるAIアシスタントまたは開発環境と連携するように設計されています。エコシステムは成長していますが、現在の既知の統合または互換性のあるプラットフォームには以下が含まれます。

Windsurf
Cursor
GitHub Copilot
Claude Desktop

プロジェクトにカスタムツールでMCP Unityを拡張できますか？

はい、もちろんです！MCP Unityアーキテクチャの重要な利点の1つは、その拡張性です。

Unity内（C#）: McpToolBase（またはリソースの同様のベース）を継承する新しいC#クラスを作成して、カスタムUnityエディター機能を公開できます。これらのツールは、McpUnityServer.csに登録されます。たとえば、プロジェクト固有のアセットインポートパイプラインを自動化するツールを作成できます。
Node.jsサーバー内（TypeScript）: 次に、Server/src/tools/ディレクトリに対応するTypeScriptツールハンドラーを定義し、入力/出力のZodスキーマを含め、Server/src/index.tsに登録します。このNode.js部分は、新しいC#ツールへのリクエストをUnityに転送します。

これにより、AIの機能をゲームやアプリケーションの特定のニーズとワークフローに合わせて調整できます。

MCP Unityは無料で利用できますか？

はい、MCP UnityはMITライセンスの下で配布されているオープンソースプロジェクトです。ライセンス条項に従って、自由に利用、変更、配布できます。

MCP Unityに接続できないのはなぜですか？

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!