[!IMPORTANT] Unionは非推奨となりました。Unity公式のMCPサーバーを使用してください。

Union ♾️ - Unity MCP サーバー

UnityのためのModel Context Protocolサーバー

主な機能

• 🖼️ マルチモーダルビジョン: エージェントがあなたの見ているものを見ることができます。シーンの表示、カメラ越しの確認、プレイモードの監視、アセットのサムネイル確認が可能です。

• 🔎 強力な検索: プロジェクトパネルを超えて、ヒエラルキーとプロジェクトアセットを同時に検索できます。

• ✔️ 優れたコード分析: Unity独自のコンパイラを活用し、エージェントのリンターよりも正確なコード分析を行います。

• ⏩ クイックスタート: mcp.json 設定ファイル1つで数秒で実行可能です。

• 🛠️ 拡張性: 最小限のボイラープレートで、プロジェクト固有のツールを追加できます。

• 📅 常に最新: 最新のMCPプロトコルバージョンに追従しています。現在は Official MCP C# SDK を介して 2025-06-18 に対応しています。

Related MCP server: Unity MCP Server

互換性

セットアップ

1. node.js をインストール

2. mcp.json を設定

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@nurture-tech/unity-mcp-runner", "-unityPath", "<path to unity editor>", "-projectPath", "<path to unity project>"]
    }
  }
}

これにより、Unityプロジェクトに is.nurture.mcp パッケージが自動的にインストールされます。これらの変更をソース管理にコミットしても問題ありません。

ツールについて

Unity AIツールボックスのご紹介。

既知の問題

• Google External Dependency Manager (EDMU) を使用している場合、WindowsでCursor経由で起動するとUnityが起動時にフリーズすることがあります。現在調査中です。

• test_active_scene ツールが Maximum call stack size exceeded. というエラーメッセージで失敗することがあります。

• search ツールが Search index is not ready yet. Please try again later. というエラーメッセージで失敗することがあります。

プロジェクト固有のツールの追加

Unionは公式の C# MCP SDK を使用しています。

1. ツールを保持するための静的クラスを作成します。クラスに [McpServerToolType] アノテーションを追加します。

2. 各ツールを実装するための静的メソッドを宣言します。各メソッドに [McpServerTool] アノテーションを追加します。

3. 例については Services ディレクトリを参照してください。

4. 新しいツールを認識させるには、Unityを終了してエージェントを再起動する必要がある可能性が高いです。

使用のヒント

Unionを最大限に活用するためのヒントをいくつか紹介します：

• 🚀 エージェント経由で起動: 常にAIエージェントのMCP統合を通じてUnityを起動してください。HubからUnityを起動すると、MCPサーバーが接続できなくなります。

• 📂 プロジェクトごとの設定: エージェントがサポートしている場合は、プロジェクトごとの設定でMCPサーバーを構成してください。これにより、Unityプロジェクト間をシームレスに切り替えることができます。

• ⚙️ コマンドライン引数: CI/CDパイプラインなどで -batchmode や -nographics で実行するような高度なシナリオでは、Unityに追加の引数を渡すことができます。Unity固有の引数の前に -- セパレーターを追加してください：

  {
    "mcpServers": {
      "unity": {
        "command": "npx",
        "args": [
          "-y",
          "@nurture-tech/unity-mcp-runner"
          "-unityPath",
          "<path to unity editor>",
          "-projectPath",
          ".",
          "--",
          "-batchmode",
          "-nographics"
        ]
      }
    }
  }

• ⚠️ 重要: -logFile コマンドライン引数は使用しないでください。MCPサーバーは通信のためにUnityの標準出力に依存しています。

• 🖥️ ビジョン用の画面分割: screenshot のようなツールを使用する場合、Unityエディタが画面に表示されていることを確認してください。そうでない場合、フォアグラウンドウィンドウのスクリーンショットが撮影されてしまいます。