Unitymcp VRC

🚀 このプロジェクトについて

このリポジトリは、Arodoid/UnityMCP からフォークし、大幅にリファクタリングされたものです。私はClaude/MCP/Unityを使用してVRChatのワールドを作成するテストを行っています。ClaudeがUdonSharpスクリプトをコンパイルする際に問題があったため、このリポジトリではMCPリソースと補助スクリプトをサポートし、VRCワールドの構築成功率を向上させています。

さらに、このリポジトリには、一般的なUnity開発に役立つ多くの改善点が含まれています。是非試してみてください！

✨ 主な機能

コマンド実行

• コード実行方法を変更し、大規模言語モデル（LLM）がusing、クラス、関数を定義できるようにしました。
  • LLMが複数の機能を含むより複雑なコマンドを実行できるようになります。
• エラースタックは大量のコンテキスト情報を消費するため、通常は最初の行のみを返せば十分です。
• 以下のモジュールへの参照を追加しました。
  • .Net Standard
  • System.Core、System.IO
  • TextMeshProアセンブリ
  • VRChatアセンブリ
  • Unity Physics
  • MCPUnity自体への参照を追加し、MCPコマンドに補助機能を提供します。

Unityエディタ統合

• Unityが接続されていない場合の待機/リトライ機能を追加しました。
• getEditorStateを必要に応じて実行するように変更しました。
• エディタ状態の取得とコマンドの実行時にコンパイル完了を待つ機能を実装しました。
• GetAssetsを再実装し、Assetsフォルダ内のすべての内容を検索できるようにしました。

手動スクリプトテスト

• C#コマンドを診断するためのスクリプトテストツールを作成しました。
• 詳細なログを伴うエディタコマンドを手動で実行できるようにしました。

MCPリソース

• resources/textフォルダに追加されたすべてのファイルをMCPリソースとして公開します。

パフォーマンス

• 変更が検出された場合のみ再描画することで、MCPウィンドウの高いCPU使用率を低減しました。
• Unityで4KBを超えるコマンドをサポートしました。
• 再接続中の過剰なデバッグログを削減しました。

コードリファクタリング

• Unity接続ロジックを独立したファイルにリファクタリングしました。
• MCPサーバツールを別のファイルに分離し、新機能の追加を簡素化するための汎用インターフェースを実装しました。
• エディタ状態レポートとコマンド実行を独立したファイルに分割しました。

VRChat特定機能

• C#ファイルからUdonSharpアセットファイルを生成するための補助スクリプトを追加しました。

📦 インストール

1. unity-mcp-serverディレクトリでMCPサーバをビルドします。

   • ターミナルを開き、そのディレクトリに移動してビルドコマンドを実行します。

2. UnityMCPPluginフォルダをプロジェクトのAssetsフォルダにコピーし、Unityで新しいメニューオプションを見つけます。

   • プラグインが正しくインポートされ、プロジェクト設定で有効になっていることを確認してください。

3. Claude Desktopで開発者モードを有効にし、以下のMCPサーバ設定を追加します。

   {
     "server": "http://localhost:XXXX"
   }
   

   ここで、XXXXはサーバが実際に動作しているポート番号です。

4. 接続状態を確認し、プロンプトを実行し、リソース添付機能を使用します。

   • すべての必要なポートとファイアウォール設定が正しく構成され、通信が許可されていることを確認してください。

📄 ライセンス

このプロジェクトは、クリエイティブ・コモンズ 表示 - 非営利 4.0 国際ライセンスの下で提供されています。