ChiR24/Unreal_mcp

解決する問題

このプロジェクトは、AI アシスタント（Claude、Cursor、VS Code など）と Unreal Engine エディターの間のブリッジを提供します。AI がエディターと直接対話して、レベル構築、ブループリント作成、UI デザイン、マテリアル設定、ゲームプレイシステム管理を可能にし、ユーザーがエンジン内で手動ですべての操作を行う必要をなくします。

仕組み

このシステムは、Unreal Engine 内で実行される MCP Automation Bridge と呼ばれるネイティブ C++ エディタープラグインで構成されています。AI クライアントは、Model Context Protocol (MCP) を使用して、次の 2 つの経路でこのプラグインに接続します。

• 経路 A（ネイティブ HTTP）： クライアントはプラグインの HTTP サーバー（デフォルトポート 3000）に直接接続し、認証に機能トークンを使用します。
• 経路 B（stdio）： クライアントは Node.js サーバー（unreal-engine-mcp-server）を介して接続し、stdio と WebSockets（デフォルトポート 8090）を介してプロキシとして機能します。

このプラグインは、数百の個別ツールを公開する代わりに、単一の unreal ツールを公開します。AI アシスタントはゲートウェイフローを使用します。機能（例：「アクターをスポーン」）を検索し、必要なパラメータを取得するために特定のアクションを説明し、アクションを実行します。

対象ユーザー

Unreal Engine 5.0 から 5.8 を使用するゲーム開発者やテクニカルアーティストで、エディタータスクを自動化したり、AI を使用してレベルデザイン、ブループリント作成、ワールド構築プロセスを加速したい方。

ハイライト

• 広範な機能： レベル、アクター、ブループリント、UI、UMG、マテリアル、Niagara エフェクト、AI ビヘイビアツリーにわたる約 400 のエディターアクション。
• 柔軟な接続性： さまざまな AI クライアントに対応するため、直接 HTTP と stdio トランスポートの両方をサポート。
• ネイティブ統合： ゲームスレッドでエディター API への深いアクセスを確保するために C++ プラグインとして構築。
• 安全メカニズム： 破壊的なアクションには、誤って削除されないように特定の同意付与が必要。
• AI フレンドリーな発見： AI が数百のツール名を記憶する必要がないように、検索ベースのシステムを使用。