unity-mcp-for-server

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

このプロジェクトは、Unityエディター用のMCPサーバーをNode.jsで構築するための手順を提供します。Node.jsとnpmの要件を満たし、サーバーのインストールと設定方法が詳細に説明されています。特に、WindowsとmacOSのインストール手順が明確に示されており、ユーザーが簡単にサーバーを立ち上げられるようになっています。

GitHub

GitHubスター

ユーザー評価

未評価

フォーク

イシュー

閲覧数

お気に入り

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 をオフにすることです。