unity-mcp-for-server

Name: unity-mcp-for-server
Availability: InStock
Author: sinkect

This project provides instructions for setting up an MCP server for the Unity editor using Node.js. It outlines the requirements for Node.js and npm, detailing the installation and configuration steps. The instructions are clearly laid out for both Windows and macOS, making it easy for users to get the server up and running.

GitHub

GitHub Stars

User Rating

Not Rated

Forks

Issues

Views

Favorites

README

MCP Unity エディター MCP PC (LLM)

要件

Node.js 18以降 - サーバーを起動するため
npm 9以降 - サーバーをデバッグするため

インストール

ステップ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: 手動設定

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つの方法があります：

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

Unityエディターを開く
Tools > MCP Unity > Server Windowに移動
"Start Server"ボタンをクリック

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

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

サーバーのデバッグ

MCP Unityサーバーをデバッグするには、以下の方法を使用できます：

オプション1: Unityエディターを使用してデバッグ

Unityエディターを開く
Tools > MCP Unity > Server Windowに移動
"Debug Server"ボタンをクリック

オプション2: コマンドラインを使用してデバッグ

ターミナルまたはコマンドプロンプトを開く
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 をオフにすることです。