Unitymcpintegration

🚀 Unity MCP 統合

Unity MCP 統合により、AI アシスタントは MCP プロトコルを通じて Unity エディタとやり取りすることができます。この統合は、AI アシスタントがコード操作を実行し、ファイルシステムを管理し、Unity プロジェクトの状態を監視できるようにする包括的なツールセットを提供します。

✨ 主な機能

🛠️ Unity エディタツール

• get_editor_state: Unity プロジェクトとエディタの状態に関する詳細情報を取得します。
• get_current_scene_info: 現在のシーンの詳細情報を取得します。
• get_game_objects_info: 特定のゲームオブジェクトの情報を取得します。
• execute_editor_command: Unity エディタ内で直接 C# コードを実行します。
• get_logs: Unity コンソールのログを検索し、フィルタリングします。
• verify_connection: Unity エディタとの有効な接続があるかどうかを確認します。

📁 ファイルシステムツール

• read_file: プロジェクト内のファイルの内容を読み取ります。
• read_multiple_files: 複数のファイルを一度に読み取ります。
• write_file: 指定されたファイルを作成または上書きします。
• edit_file: 既存のファイルを対象的に編集し、プレビュー機能付きです。
• list_directory: ディレクトリ内のファイルとフォルダのリストを取得します。
• directory_tree: ディレクトリの階層構造ビューを取得します。
• search_files: 特定のパターンに一致するファイルを検索します。
• get_file_info: 特定のファイルまたはディレクトリのメタデータを取得します。
• find_assets_by_type: タイプに基づいてすべてのアセット（例: Material、Prefab）を検索します。
• list_scripts: プロジェクト内のすべての C# スクリプトのリストを取得します。

ファイルパスは、絶対パスまたは Unity プロジェクトの Assets フォルダに対する相対パスのいずれでも構いません。例えば、"Scenes/MyScene.unity" は実際には <project>/Assets/Scenes/MyScene.unity を指します。

🏷️ 環境要件

• Unity エディタ: 2018.4 以上のバージョンをサポート
• Node.js: バージョン 16.0 以上

📦 インストール

npm を使用したインストール

npm install @quaza/unitymcpintegration

🛠️ 開発環境のインストール

Unity プラグイン

1. Unity でプロジェクトを開きます。
2. UnityMCPConnection/Editor ディレクトリ内の C# スクリプトを変更します。

MCP サーバー側

1. mcpServer ディレクトリに切り替えます。
2. 依存関係をインストールします: npm install
3. サーバーをコンパイルします: npm run build
4. サーバーを起動します: node build/index.js

🚀 クイックスタート

MCP サービスの初期化

プロジェクトのルートディレクトリで以下のコマンドを実行します。

npx @quaza/unitymcpintegration init

これにより、必要な設定ファイルとディレクトリ構造が作成されます。

MCP サーバーの起動

以下のコマンドを実行して MCP サービスを起動します。

npm run start

💻 使用例

基本的な使用法

Unity での使用

using MCPIntegration;

public class MCPExample : MonoBehaviour {
    void Start() {
        // 初始化 MCP 客户端
        MCPClient.Initialize("localhost", 3000);
        
        // 获取编辑器状态
        EditorState state = MCPClient.GetEditorState();
        Debug.Log($"Editor Version: {state.Version}");
    }
}

Node.js での使用

const mcpServer = require('@quaza/unitymcpintegration');

// 初始化服务器
mcpServer.initialize('localhost', 3000);

// 监听文件变化事件
mcpServer.on('fileChanged', (event) => {
    console.log(`File changed: ${event.path}`);
});

📄 ライセンス

このライブラリは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

🔗 リンク

• GitHub リポジトリ: https://github.com/quaza/unitymcpintegration
• ドキュメントサイト: https://docs.quaza.com/unity-mcp-integration

Unity MCP 統合を通じて、AI 機能をゲーム開発のワークフローにシームレスに統合し、開発効率を向上させ、可能性を拡大することができます。