Unreal MCP

Unreal MCPはAI Game DeveloperのUnreal Engineプラグインです。Claude Code、Cursor、GitHub Copilot、Codex、GeminiなどのAIエージェントがUnreal Editor内で作業できるようにします。アクター、コンポーネント、アセット、レベルの照会と変更、Blueprintの作成とコンパイル、C++の編集とコンパイル、エディタPythonの実行、エージェントが確認できるスクリーンショットの取得などが可能です。やりたいことを自然言語で伝えると、エージェントがModel Context Protocol（MCP）を通じてエディタのツールを呼び出します。

このwikiでは、プラグインのインストール方法、AIクライアントの接続方法、Unreal EditorでAIから有用な結果を得る方法を説明します。プラグインはベータ版で、現在のリリースは0.26.2です。

構成要素の関係#

Unreal MCPのセットアップは4つの部分から成ります。これらを理解しておくと、セットアップとトラブルシューティングがずっと楽になります。

• Unreal MCPプラグイン（UnrealMCP）。プロジェクトのPlugins/フォルダにインストールするC++エディタプラグインです。AIツールを登録し、エディタにAI Game Developerウィンドウを追加します。
• ブリッジ（unreal-mcp-bridge）。UnrealのエディタはC++で動作するため、.NET製のMCPホストはエディタの隣で小さなヘルパープロセスとして実行されます。プラグインが自動的に起動し、ローカルのトークンで保護された接続を介して通信します。パッケージ版にはブリッジが同梱されているため、.NETをインストールする必要はありません。
• MCPサーバー。デフォルトでは、ブリッジはai-game.devでホストされているサーバーに接続します（Cloudモード）。代わりに、共有のローカルサーバーgamedev-mcp-serverを自分のマシンで実行することもできます（Customモード）。
• AIクライアント。任意のMCPクライアントが同じサーバーに接続し、それを介してエディタに到達します。

セットアップに役立つツールが2つあります：

• AI Game Dev（デスクトップアプリ）は、Unrealプロジェクトにプラグインをインストールし、エディタを開くこともできます。Node.jsは不要です。詳しくはアプリのwikiをご覧ください。
• **unreal-mcp-cli**は、npmで配布されているクロスプラットフォームのコマンドラインツールです。プラグインのインストールと更新、サインイン、MCPクライアント設定の書き込み、エディタの起動、ターミナルやCIからのツール実行を行います。

AIエージェントにできること#

このプラグインには7ファミリー・27個のツールが含まれています。エディタのデータのほとんどは、操作ごとに1つのツールを使うのではなく、エディタ全体で共通のクエリ言語であるRQLを通じて扱われます：

• RQL（rql-query、rql-mutate、rql-schema）：アクター、コンポーネント、アセット、レベル、DataTable、Gameplayタグ、Project Settings、Blueprintグラフ、Widget Blueprint、Level Sequenceの検索と変更。
• Blueprints：Blueprintの作成、編集、コンパイル。エージェントが修正できる構造化されたエラーリスト付きです。
• C++ソース：プロジェクトのC++の読み取り、雛形生成、編集、コンパイル（Live CodingまたはUnreal Build Tool）。
• Python：unrealエディタAPIをフルに使ってPythonを実行。
• スクリーンショット：ビューポート、ゲームビュー、カメラ、アクター単体のキャプチャ。
• コンソールおよびツール一覧のヘルパー。

6つのオプション拡張により、Control Rig、Enhanced Input、Gameplay Ability System、LandscapeとWater、Niagara、PCGのサポートが追加されます。任意のUnrealプラグインから独自のツールを登録することもできます。

Wikiページ#

次に読むもの#

• 初めての方はインストールから始め、次にはじめにへ進んでください。
• 手短に知りたい方は、Unreal Engineインストールページとクイックスタートに要点がまとまっています。
• ツールの詳細をお探しですか？Unreal ツールカタログとUnreal ベストプラクティスをご覧ください。
• 別のエンジンも併用していますか？Unity wikiとGodot wikiをご覧ください。3つのプラグインはすべて同じサーバー、アカウント、AI クライアントを共有しています。