Unity MCP

🚀 Unity MCP プラグイン更新ログ

このプラグインは、Unity での MCP 機能を強化し、パフォーマンスを最適化し、開発者により多くのオプションを提供します。

✨ 主な機能

• MCP サーバとクライアント間の通信プロトコルを更新しました。
• カスタムツールのサポートを追加しました。
• より詳細なエラーメッセージとデバッグ情報を提供します。
• 特に大規模シーンの処理におけるパフォーマンスを最適化しました。

🔍 既知の問題

1. カスタムツールのサポート制限：csharp-sdkに未解決の問題があるため、現在はカスタムツールの開発を完全にサポートできません。以下の2つの問題をご確認ください。

   • GitHub ディスカッション
   • GitHub 問題

2. マルチスレッド処理の制限：一部のツールはメインスレッド外で実行する必要がありますが、現在のプラグインでは Unity API との互換性を確保するため、メインスレッドの使用が強制されています。

📥 ダウンロード先

• GitHub リポジトリ
• Releasesページ

📚 ドキュメント

🚀 クイックスタート

1. プロジェクトパスの要件：

   • Unity プロジェクトのパスに空白が含まれていないことを確認してください。例えば：

     C:/MyProjects/Project
     

     以下のような空白を含むパスではなく：

     C:/My Projects/Project
     

2. Unity プロジェクトを開いた後、メニューバーの Window -> AI Connector (Unity-MCP) を選択します。

   

3. MCP クライアントのインストール：

   • Cursor の使用をおすすめします。
   • または Claude を使用することもできます。

4. MCP クライアントにログインします。

5. Configure をクリックして、プラグインの設定を行います。

   

6. MCP クライアントを再起動します。

7. AI Connector の状態が "Connected" または "Connecting..." であることを確認します。

8. MCP クライアントでプラグインの機能をテストします。例えば：

   • デフォルトのツールを使用してシーンを分析する。
   • カスタムツールの呼び出しを検証する。

💻 使用例

基本的な使用法

以下は、Unity プロジェクトのパスに関する注意事項のサンプルです。

C:/MyProjects/Project

高度な使用法

カスタムツールの開発に関するガイドラインを以下に示します。

ツールクラスの作成

1. MCP_Tool を継承する新しいクラスを作成します。
2. そのクラスに [McpTool] 属性を追加し、ツール名と説明を指定します。

[McpTool("CustomTool", "これはカスタムツールです")]
public class CustomTool : MCP_Tool
{
    // ツールのロジックを実装します
}

メソッドの定義

1. [McpCommand] 属性を使用して、実行可能なコマンドをマークします。
2. メソッドにパラメータの説明を追加します。例えば：

[McpCommand("ProcessScene", "現在のシーンを処理します")]
public void ProcessScene([McpParam("filePath", "入力ファイルのパス")] string filePath)
{
    // 処理ロジックを記述します
}

パラメータの説明

• [McpParam] 属性を使用して、パラメータに説明情報を追加します。例えば：

  [McpParam("radius", "処理半径")]
  float radius = 1.0f;
  

🤝 貢献ガイド

1. Unity-MCP リポジトリ をフォークします。
2. Pull Request を送信する前に、すべてのテストケースを通過することを確認してください。
3. Issues で問題を報告したり、改善提案を行ったりしてください。