| English | 🇨🇳简体中文 | 🇯🇵日本語 |
|---|
,/(/. *(/,
*/(((((/. *((((((*.
.*((((((((((/. *((((((((((/.
./((((((((((((((/ *((((((((((((((/,
,/(((((((((((((/*. */(((((((((((((/*.
,%%#((/((((((* ,/(((((/(#&@@(
,%%##%%##((((((/*. ,/((((/(#&@@@@@@(
,%%######%%##((/(((/*. .*/(((//(%@@@@@@@@@@@(
,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@(
,%%####%( /#%#%%%##(//(#@@@@@@@%, #@@@@@@@(
,%%####%( *#%###%@@@@@@( #@@@@@@@(
,%%####%( #%#%@@@@, #@@@@@@@(
,%%##%%%( #%#%@@@@, #@@@@@@@(
,%%%#* #%#%@@@@, *%@@@(
., ,/##*. #%#%@@@@, ./&@#* *`
,/#%#####%%#/, #%#%@@@@, ,/&@@@@@@@@@&\.
`*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´
`*%%###########%@@@@@@@@@@@@@@&*´
`*%%%######%@@@@@@@@@@&*´
`*#%%##%@@@@@&*´
`*%#%@&*´
███╗ ███╗ ██████╗██████╗ ██╗ ██╗███╗ ██╗██╗████████╗██╗ ██╗
████╗ ████║██╔════╝██╔══██╗ ██║ ██║████╗ ██║██║╚══██╔══╝╚██╗ ██╔╝
██╔████╔██║██║ ██████╔╝ ██║ ██║██╔██╗ ██║██║ ██║ ╚████╔╝
██║╚██╔╝██║██║ ██╔═══╝ ██║ ██║██║╚██╗██║██║ ██║ ╚██╔╝
██║ ╚═╝ ██║╚██████╗██║ ╚██████╔╝██║ ╚████║██║ ██║ ██║
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝
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_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://hierarchy: Unity階層内のすべてのゲームオブジェクトのリストを取得例: "現在のシーンの階層構造を表示"
-
unity://gameobject/{id}: シーン階層内のインスタンスIDまたはオブジェクトパスで特定のGameObjectに関する詳細情報を取得例: "Player GameObjectに関する詳細情報を取得"
-
unity://logs: Unityコンソールからのすべてのログのリストを取得例: "Unityコンソールからの最近のエラーメッセージを表示"
-
unity://packages: Unityパッケージマネージャーからインストール済みおよび利用可能なパッケージに関する情報を取得例: "Unityプロジェクトに現在インストールされているすべてのパッケージをリスト"
-
unity://assets: Unityアセットデータベース内のアセットに関する情報を取得例: "プロジェクト内のすべてのテクスチャアセットを検索"
-
unity://tests/{testMode}: Unityテストランナー内のテストに関する情報を取得例: "Unityプロジェクトで利用可能なすべてのテストをリスト"
- Unity 2022.3以降 - サーバーをインストールするため
- Node.js 18以降 - サーバーを起動するため
- npm 9以降 - サーバーをデバッグするため
このMCP Unityサーバーのインストールは複数ステップのプロセスです：
- Unityパッケージマネージャーを開く（Window > Package Manager）
- 左上隅の"+"ボタンをクリック
- "Add package from git URL..."を選択
- 入力:
https://github.com/CoderGamester/mcp-unity.git - "Add"をクリック
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
オプション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つの方法があります：
- Unityエディターを開く
- Tools > MCP Unity > Server Windowに移動
- "Start Server"ボタンをクリック
- ターミナルまたはコマンドプロンプトを開く
- MCP Unityサーバーディレクトリに移動
- 以下のコマンドを実行：
node Server~/build/index.js
デフォルトでは、MCPサーバーとWebSocket間のタイムアウトは 10 秒です。 お使いのOSに応じて変更できます。
Option 1: Windows OS
- Unityエディターを開きます
- Tools > MCP Unity > Server Window に移動します
- Request Timeout (seconds) の値を希望のタイムアウト秒数に変更します
- Unityはシステム環境変数UNITY_REQUEST_TIMEOUTに新しいタイムアウト値を設定します
- Node.jsサーバーを再起動します
- Start Server をもう一度クリックして、UnityエディターのWebソケットをNode.js MCPサーバーに再接続します
Option 2: Windows以外のOS
Windows 以外の OS の場合は、次の 2 か所で設定する必要があります。
- Unityエディターを開きます
- Tools > MCP Unity > Server Window に移動します
- Request Timeout (seconds) の値を希望のタイムアウト秒数に変更します
- ターミナルで UNITY_REQUEST_TIMEOUT 環境変数を設定します
- Powershell
$env:UNITY_REQUEST_TIMEOUT = "300"
- Command Prompt/Terminal
set UNITY_REQUEST_TIMEOUT=300
- Node.jsサーバーを再起動します
- Start Server をもう一度クリックして、UnityエディターのWebソケットをNode.js MCPサーバーに再接続します
Tip
AIコーディングIDE（Claude Desktop、Cursor IDE、Windsurf IDE など）とMCPサーバー間のタイムアウト設定は、IDEによって異なります。
MCP Unityサーバーをデバッグするには、以下の方法を使用できます：
- Unityエディターを開く
- Tools > MCP Unity > Server Windowに移動
- "Debug Server"ボタンをクリック
- ターミナルまたはコマンドプロンプトを開く
- MCP Unityサーバーディレクトリに移動
- 以下のコマンドを実行：
npm run debug
接続の問題
- WebSocketサーバーが実行中であることを確認してください（UnityのServer Windowを確認）
- ファイアウォールの制限が接続を妨げていないか確認してください
- ポート番号が正しいことを確認してください（デフォルトは8080）
- UnityエディターのMCP Serverウィンドウでポート番号を変更できます（ツール > MCP Unity > Server Window）
サーバーが起動しない
- Unityコンソールにエラーメッセージがないか確認してください
- Node.jsが正しくインストールされ、PATHで利用可能であることを確認してください
- Serverディレクトリ内の依存関係がすべてインストールされていることを確認してください
Play Modeテスト実行時の接続失敗
run_tests ツールは以下の応答を返します：
Error:
Connection failed: Unknown error
このエラーは、Play Modeへ切り替える際にドメインリロードが発生し、ブリッジ接続が失われるために発生します。
回避策は、Edit > Project Settings > Editor > "Enter Play Mode Settings" で Reload Domain をオフにすることです。
ご質問やサポートが必要な場合は、このリポジトリのissueをご利用ください。
また、以下でも連絡可能です：
- Linkedin:
- Discord: gamester7178
- メール: game.gamester@gmail.com
コントリビューションは大歓迎です！Pull Requestの送信やIssueの提出をお待ちしています。
変更は Conventional Commits フォーマットに従ってください。
本プロジェクトは MIT License の下で提供されています。
貢献は大歓迎です！詳細については貢献ガイドをお読みください。
このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。