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
AIクライアントのMCP設定ファイル（例：Claude Desktopのclaude_desktop_config.json）を開き、以下のテキストをコピー：
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": [
"ABSOLUTE/PATH/TO/Server/build/index.js"
],
"env": {
"UNITY_HOST" : "YOUR_IP_ADDRESS",
"UNITY_PORT" : "YOUR_PORT"
}
}
}
}MCP Unityサーバーを起動するには2つの方法があります：
- Unityエディターを開く
- Tools > MCP Unity > Server Windowに移動
- "Start Server"ボタンをクリック
- ターミナルまたはコマンドプロンプトを開く
- MCP Unityサーバーディレクトリに移動
- 以下のコマンドを実行：
node Server/build/index.js
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 をオフにすることです。
本プロジェクトは MIT License の下で提供されています。
貢献は大歓迎です！詳細については貢献ガイドをお読みください。
このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。