UE‑MCP – Unreal Engine モデルコンテキストプロトコルサーバー

概要 – Node.js/TypeScript サーバーで、C++ ブリッジプラグインを介して AI アシスタントが Unreal Editor と通信できるようにします。約 2,040 のエディター操作（レベル、ブループリント、マテリアル、VFX、PCG など）を JSON‑RPC 呼び出しとして公開し、自然言語コマンドで UE 5 プロジェクトを作成、読み取り、または変更できます。

仕組み

• ue-mcp は UE プロジェクトに小さな C++ プラグインをインストールし、WebSocket‑JSON‑RPC サーバーを起動します。
• AI クライアントは平文（または構造化）コマンドを送信し、サーバーはブリッジを介してそれらを UE API 呼び出しに変換します。
• アクションは ue-mcp.yml YAML フローでも構成でき、多段階で再現可能なワークフローを実現します。
• npm ベースのプラグインシステムにより、開発者は新しいアクションやカテゴリ全体を追加できます。

主な機能

• 29 のツールカテゴリ – レベルレイアウトからアニメーション、Niagara、PCG、GAS、ネットワーキング、新しい UE 5.8 ネイティブツールセットまでを網羅。
• 組み込みの 19 ステップデモ – ブリッジのみを使用して「Neon Shrine」シーンを手続き的に構築。
• 安全ガード – 書き込み保護、ソース管理チェック、フローロールバックでプロジェクトを保護。
• 拡張可能 – 新しいアクションを注入する npm プラグイン（ue-mcp-<plugin>）を公開可能。
• YAML フロー – リトライ、ロールバック、カスタム JS/TS タスクを備えた再現可能なパイプラインを定義。
• クロスプラットフォーム – Windows、macOS、Linux（UE 5.4‑5.8）で動作。

典型的なユースケース

• 大規模言語モデル（例：Claude、Cursor）にレベル、アセット、ゲームプレイシステムを反復設計させる。
• 繰り返しのエディタータスク（バッチインポート、マテリアル生成、ビルドパイプライン）を自動化。
• 手動 UI 操作なしでプロシージャルコンテンツ生成パイプラインをプロトタイプ化。
• ゲーム開発スタジオのツール内に AI 駆動の「アシスタント」機能を提供。

はじめに

npx ue-mcp init   # .uproject を検出し、ブリッジをデプロイし、必要な UE プラグインを有効化
npx ue-mcp doctor # 接続の問題をトラブルシューティング

エディターを再起動した後、次のようなコマンドを送信します：

"プレイヤースタートの 300 ユニット上にポイントライトを配置、強度 5000。"
"Development 構成でプロジェクトをビルドし、コンパイルエラーを報告してください。"

インストール要件

• Unreal Engine 5.4‑5.8（Windows）または 5.6+（Linux/macOS）。
• Node 18+。
• C++ ツールチェーン（Windows では Visual Studio、macOS では Xcode CLI、Linux では gcc/clang）。
• PythonScriptPlugin（UE に同梱）– init によって自動的に有効化。

ドキュメントとコミュニティ

• 完全なドキュメント：https://ue-mcp.com/docs（入門、ツールリファレンス、フロー、プラグイン、トラブルシューティング）。
• MIT ライセンス、スポンサー歓迎、PR と issue を受け付けています。

制限 / 考慮事項

• コンパイル済みの C++ ブリッジが必要です。エディターを再起動しない場合やツールチェーンがない場合、初回実行が失敗する可能性があります。
• 書き込みアクセスにより、AI がプロジェクトファイルを完全に制御できます – 安全ガードはオプションですが推奨されます。
• UE 5 のみをサポート。古いエンジンバージョンは対象外です。

ライセンス – MIT（個人、教育、商用利用は無料）。