Unity

🚀 UnityMCP

UnityMCPは、Model Context Protocol (MCP)を実装した強力なUnityエディタープラグインです。これにより、UnityとAIアシスタント間の統合がシームレスに行われます。リアルタイムのエディター状態監視、リモートコマンド実行、および包括的なログ記録機能を提供します。

🚀 クイックスタート

UnityMCPは、UnityエディターとAIアシスタントの間のシームレスな統合を可能にする強力なプラグインです。以下のセクションでは、インストール、設定、使用方法について説明します。

✨ 主な機能

• コア機能：WebSocketを通じた双方向のリアルタイム通信を実現し、JSON形式のメッセージ伝送をサポートします。
• アプリケーションシナリオ：ゲーム開発、リアルタイムコラボレーションツール、または動的なデータ交換が必要な他のアプリケーションなど、リアルタイムインタラクションが必要なシナリオに適しています。
• ターゲットユーザー：開発者、デザイナー、および研究者。

📦 インストール

1. Smitheryを使用したインストール

# 示例代码：通过Smithery进行安装

2. 手動インストール

• プラグインのインストール：

  • UnityMCP フォルダをあなたのUnityプロジェクトに配置します。
  • Unityでこのフォルダをインポートして、プラグインのインストールを完了します。

• サーバーの設定：

  • Node.jsとnpmがインストールされていることを確認してください。
  • プロジェクトディレクトリで以下のコマンドを実行します。

    npm install
    

💻 使用例

サーバーの起動

node server.js

プラグインの接続

1. Unityエディターを開きます。
2. Assets/Editor フォルダに MCPManager.cs スクリプトを追加します。
3. スクリプトを任意の空のオブジェクトにアタッチします。
4. WebSocketサーバーのアドレスを設定します（デフォルトは ws://localhost:8080）。

開発ガイド

コンパイルとビルド

npm run build

コードの変更を監視

npm run watch

通信のデバッグ

npm run inspector

🔧 技術詳細

通信プロトコル

• 伝送方式：WebSocketに基づくリアルタイム双方向通信。
• ポート番号：デフォルトでは8080ポートを使用します。
• メッセージ形式：すべての通信はJSON形式で行われます。

セキュリティ機構

• コマンドタイムアウト保護：長時間応答のないコマンドの実行を防止します。
• エラー処理：接続異常、コマンド失敗、コンパイルエラー、およびランタイム例外を含む包括的なエラー処理。
• ログ管理：信頼性の高いログ記録とバッファリング機能を提供します。
• 状態監視：接続状態をリアルタイムで追跡し、システムの安定性を確保します。

エラー処理

システムは、以下の状況に対して完全な処理メカニズムを提供します。

• 接続切断
• コマンド実行失敗
• コンパイルエラー
• ランタイム例外
• タイムアウト問題

📄 ライセンス

このプロジェクトは Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) ライセンスの下で提供されています。