Unity Code MCP

🚀 Unity Code MCP

Unity Code MCPは、AIエージェントがUnityコードを自律的に記述できるようにする、コーディングに特化したモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

🎯 Unity Code MCPの魅力

Unity Code MCPは、Rustで構築された高性能でコーディングに特化したMCPサーバーです。Unityのコンパイルサイクルを円滑に処理し、自律的なコード開発に必要な基本的なツール（コンパイルフィードバックとテスト実行）のみを提供します。

このMCPサーバーにより、AIエージェントは卓越した速度と信頼性でUnityコードを自律的に開発できます。人間が行うように、コードを記述し、コンパイルし、コンパイルエラーを修正し、テストを実行し、バグを修正し、これを繰り返します。

✨ 主な機能

• 🤖 コーディング最適化：AIエージェントの効率的なコーディングワークフローのために設計された合理化されたツール
• ⚡ 軽量で高性能：Rustで構築されており、卓越した速度、最小限のメモリ使用量、そして高速な応答時間を実現します。ワークスペースがUnityプロジェクトでない場合は1MBのメモリしか使用せず、Unityエディターが開いている場合は10MBのみです。また、Unityエディターとの通信はUDPに基づいているため、システムへの負荷が最小限です。
• 🎯 効率的な通信：必要な操作で最小限のトークン使用量で、関連する情報のみを返します。
• 🧪 テスト駆動：包括的なテスト実行とレポート機能
• 📦 自己完結型：実行時依存関係のない単一のバイナリ（Node.js、Python、または.NETは必要ありません）

🔧 技術詳細

🛠️ MCPサーバーツール

Unity Code MCPは、自律的なコード開発のために2つのツールを提供します。

1. アセットデータベースリフレッシュ

• Unityのコンパイルとアセット処理をトリガーします。
• コンパイルエラーとその他の非コンパイル警告およびエラーを返します（リフレッシュ中のログのみを含みます）。
• ドメインリロードを円滑に処理します。

アセットデータベースリフレッシュツールの動作：

2. テスト実行

• 包括的なレポート付きでUnityテストを実行します。
• 失敗に関する詳細なスタックトレースとログを提供します。
• EditModeとPlayModeの両方のテストをサポートします。

テスト実行ツールの動作：

🚀 自律的なAIエージェントのワークフロー例

設定が完了すると、AIエージェントは完全に自律的にUnityコードを開発できます。

ユーザー: "WASDキーで移動し、ジャンプ機能を持つプレイヤーコントローラーを作成してください。完全にテストされていることを確認してください。"

AI: 移動とジャンプ機能を備えた完全なプレイヤーコントローラーを作成し、包括的なテストを記述します。

1. [AIは移動ロジックを持つPlayerController.csを記述]
2. [AIが呼び出し: refresh_asset_database]
   → 結果: "コンパイル失敗: CS0246: 型または名前空間名 'Rigidbody' が見つかりません"
3. [AIが欠落している using UnityEngine; ステートメントを修正]
4. [AIが呼び出し: refresh_asset_database]
   → 結果: "コンパイル成功、エラーなし"
5. [AIは移動とジャンプのテストを持つPlayerControllerTests.csを記述]
6. [AIが呼び出し: run_tests]
   → 結果: "5つのテストが合格、2つのテストが失敗: Jump_ShouldApplyUpwardForceでNullReferenceException、Move_WithInvalidInputでArgumentException"
7. [AIが失敗を分析し、ヌル参照と入力検証のバグを修正]
8. [AIが呼び出し: refresh_asset_database]
   → 結果: "コンパイル成功、エラーなし"
9. [AIが呼び出し: run_tests]
   → 結果: "すべての7つのテストが成功しました"

AI: ✅ 完了！WASD移動、ジャンプ機能、および包括的なテストカバレッジを備えた完全に機能するプレイヤーコントローラーを作成しました。すべてのテストが合格しました。

これは、ユーザーの要求から完全にテストされた動作するUnityコードまで、人間の介入なしでの真の自律的開発を示しています。

AIエージェントの動作、コンテキストなしでKimi K2にUnityプロジェクトのコンパイルエラーを修正させる：

📦 インストール

前提条件

• Unity 6.0以上
• Rustツールチェーン（ソースからビルドする場合）
• CMakeとCコンパイラー（依存関係のビルドに必要）

ステップ1: Unityパッケージのインストール

UnityプロジェクトにVisual Studio Code Editorパッケージをインストールします。

ステップ2: バイナリの取得

オプションA: リリースをダウンロード（推奨）（Windowsのみ）

• 最新のバイナリをリリースページからダウンロードします。

オプションB: ソースからビルド

cargo build --release

ステップ3: AIアシスタントの設定

AIアシスタントの設定にMCPサーバーを追加します。

Cursor/Traeの場合

{
  "mcpServers": {
    "unity-code": {
      "command": "/path/to/unity-code-mcp",
      "env": {
        "UNITY_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

MCP拡張機能付きのVS Codeの場合

{
  "mcp.servers": {
    "unity-code": {
      "command": "/path/to/unity_code_mcp",
      "env": {
        "UNITY_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

Claude Desktopの場合

{
  "mcpServers": {
    "unity-code": {
      "command": "/path/to/unity_code_mcp"
    }
  }
}

⚠️ 重要提示

UNITY_PROJECT_PATH環境変数はフォールバックオプションです。IDEがMCPのroots機能をサポートしている場合、サーバーは提供されたワークスペースルートからUnityプロジェクトを自動的に検出し、環境変数よりも優先します。

💡 使用建议

${workspaceFolder}がIDEで機能しない場合は、代わりに絶対パスを使用してみてください。例えば、"UNITY_PROJECT_PATH": "/absolute/path/to/your/unity/project" のようにします。または、IDE開発者にMCPのroots機能のサポートを追加するように依頼してください。

⚠️ 重要提示

バイナリコマンドには絶対パスを使用してください。

プラットフォームサポート

コードはクロスプラットフォームですが、私はWindowsしか使用していないため、他のプラットフォームでのビルドやテストはできません。プラットフォーム固有のバグがある場合は、自分で修正する必要があります。

🧪 開発とテスト

テストの実行

テストスイートを実行するには：

1. Unityエディターを起動し、埋め込みテストプロジェクトを読み込みます。

   # Unityエディターを開き、以下のプロジェクトを読み込みます。
   # ./UnityProject
   

2. テストを実行します（Unityとの競合を避けるためにシングルスレッドで）。

   cargo test -- --test-threads=1
   

⚠️ 重要提示

テストには、埋め込みプロジェクトが読み込まれた実行中のUnityエディターインスタンスが必要です。Unityエディターとのやり取りのため、テストには30〜60秒かかる場合があります。

ソースからのビルド

前提条件

• Cコンパイラー：aws-lc-rs依存関係のビルドに必要
  • Windows: MSVC（Visual Studio Build Tools）
  • macOS: Xcodeコマンドラインツール（xcode-select --install）
  • Linux: GCC（Ubuntu/Debianではsudo apt-get install build-essential）
• CMake：aws-lc-rs依存関係のビルドに必要
  • Windows: 公式ガイドに従ってください。
  • macOS: brew install cmake
  • Linux: sudo apt-get install cmake（Ubuntu/Debian）

ビルドコマンド

# デバッグビルド
cargo build

# リリースビルド（本番環境で推奨）
cargo build --release

🤝 コントリビュート

コントリビューションは歓迎されます！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. cargo test -- --test-threads=1でテストを実行します。
4. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

🔗 関連プロジェクト

• Visual Studio Code Editor for Unity - 必要なUnityパッケージ
• Model Context Protocol - プロトコル仕様
• Unity Code Pro VS Code Extension - 関連するVS Code拡張機能