| 英語 | 🇨🇳簡体中文 | 🇯🇵日本語 |
|---|
,/(/. *(/,
*/(((((/. *((((((*.
.*((((((((((/. *((((((((((/.
./((((((((((((((/ *((((((((((((((/,
,/(((((((((((((/*. */(((((((((((((/*.
,%%#((/((((((* ,/(((((/(#&@@(
,%%##%%##((((((/*. ,/((((/(#&@@@@@@(
,%%######%%##((/(((/*. .*/(((//(%@@@@@@@@@@@(
,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@(
,%%####%( /#%#%%%##(//(#@@@@@@@%, #@@@@@@@(
,%%####%( *#%###%@@@@@@( #@@@@@@@(
,%%####%( #%#%@@@@, #@@@@@@@(
,%%##%%%( #%#%@@@@, #@@@@@@@(
,%%%#* #%#%@@@@, *%@@@(
., ,/##*. #%#%@@@@, ./&@#* *`
,/#%#####%%#/, #%#%@@@@, ,/&@@@@@@@@@&\.
`*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´
`*%%###########%@@@@@@@@@@@@@@&*´
`*%%%######%@@@@@@@@@@&*´
`*#%%##%@@@@@&*´
`*%#%@&*´
███╗ ███╗ ██████╗██████╗ ██╗ ██╗███╗ ██╗██╗████████╗██╗ ██╗
████╗ ████║██╔════╝██╔══██╗ ██║ ██║████╗ ██║██║╚══██╔══╝╚██╗ ██╔╝
██╔████╔██║██║ ██████╔╝ ██║ ██║██╔██╗ ██║██║ ██║ ╚████╔╝
██║╚██╔╝██║██║ ██╔═══╝ ██║ ██║██║╚██╗██║██║ ██║ ╚██╔╝
██║ ╚═╝ ██║╚██████╗██║ ╚██████╔╝██║ ╚████║██║ ██║ ██║
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝
MCP Unityは、Unityエディター向けのModel Context Protocolの実装であり、AIアシスタントがUnityプロジェクトと対話できるようにします。このパッケージは、UnityとMCPプロトコルを実装するNode.jsサーバー間のブリッジを提供し、Claude、Windsurf、CursorなどのAIエージェントがUnityエディター内で操作を実行できるようにします。
MCP Unityは、UnityのLibrary/PackedCacheフォルダーをワークスペースに追加することで、VSCode系IDE（Visual Studio Code、Cursor、Windsurf）との自動統合を提供します。この機能により：
- Unityパッケージのコードインテリジェンスが向上
- Unityパッケージのより良いオートコンプリートと型情報が有効化
- AIコーディングアシスタントがプロジェクトの依存関係を理解するのに役立つ
-
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プレハブを現在のシーンに追加"
-
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サーバーのインストールは複数ステップのプロセスです：
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
- Unityパッケージマネージャーを開く（Window > Package Manager）
- 左上隅の"+"ボタンをクリック
- "Add package from git URL..."を選択
- 入力:
https://github.com/CoderGamester/mcp-unity.git - "Add"をクリック
オプション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サーバーは Server~/ ディレクトリにインストールされます。
問題が発生した場合は、以下の手順で強制的にインストールできます：
- Unityエディターを開く
- メニューから Tools > MCP Unity > Server Window に移動
- 「Force Install Server」ボタンをクリック
Tip
Node.js サーバーは Server~/ ディレクトリにインストールされます。
- 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
- ターミナルまたはコマンドプロンプトを開く
- 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によって異なる場合があります。
デフォルトでは、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ライセンスの下で配布されているオープンソースプロジェクトです。ライセンス条項に従って、自由に利用、変更、配布できます。