Unreal Engine MCP完全ガイド：AIで3Dワールドを自然言語構築する仕組みとセットアップ手順

この記事ではMCPに特化して解説します。MCP（Model Context Protocol）全般は MCPサーバーの作り方2026完全ガイド をご覧ください。

Unreal Engine MCPとは何か：823スターのゲーム開発革新ツール

Unreal Engine MCPは、Unreal Engine 5.5以降をAIエージェントで制御するためのMCPサーバー実装だ。GitHubスター数823（2026年4月現在）、C++とPythonで実装されている。

Unreal Engineを使ったゲーム・VR・建築ビジュアライゼーション開発では、Blueprintビジュアルスクリプティングの習得、膨大なAPIドキュメントの理解、複雑な3Dシーンの組み立てに時間が取られる。特に「こういう挙動を実装したい」という意図は明確でも、それをBlueprint上でどう構成するかの翻訳コストが高い。

このMCPサーバーは、AIクライアント（Cursor、Claude Code、Windsurf等）とUnreal Engineエディタを直接つなぎ、自然言語の指示をエンジン操作に変換する。「キャラクターに体力システムを実装して」という指示が、Blueprintのノード作成・変数設定・接続という具体的なエンジン操作として実行される。

対応機能の全体像：Blueprint・ワールド構築・アクター管理

Unreal Engine MCPが提供するツールは6カテゴリに整理されている。

Blueprint ビジュアルスクリプティング（11ツール）

add_node、connect_nodes、delete_node、set_node_property、create_variable、set_blueprint_variable_properties、create_function、add_function_input、add_function_output、delete_function、rename_function

サポートするノードタイプは23種類以上にわたる。制御フロー（Branch、Comparison、Switch）、データ操作（VariableGet、VariableSet、MakeArray）、キャスティング（DynamicCast）、ユーティリティ（Print、CallFunction、SpawnActor）、アニメーション（PlayAnimation、StopAnimation）が含まれる。

Blueprint 分析（4ツール）

read_blueprint_content、analyze_blueprint_graph、get_blueprint_variable_details、get_blueprint_function_details

既存Blueprintの構造を読み取り、実行フロー・変数・関数の詳細を確認できる。

ワールド構築（6ツール）

create_town、construct_house、construct_mansion、create_tower、create_arch、create_staircase

1つのコマンドで複数の建物・構造物を配置してシーンを構成できる。

Epic構造物（3ツール）

create_castle_fortress、create_suspension_bridge、create_aqueduct

城塞・吊り橋・水道橋など大規模建築物の生成に対応する。

レベルデザイン（3ツール）

create_maze、create_pyramid、create_wall

迷路は再帰バックトラッキングアルゴリズムで解答経路が保証された構造として生成される。

物理・マテリアル・アクター管理（11ツール）

spawn_physics_blueprint_actor、set_physics_properties、get_available_materials、apply_material_to_actor、get_actors_in_level、find_actors_by_name、delete_actor、set_actor_transform等

物理シミュレーション設定も自然言語で操作でき、重力・質量・コリジョン設定をプロンプトで調整できる。

システムアーキテクチャ：UEプラグインとMCPサーバーの連携

ローカル方式では、PythonサーバーがMCPプロトコルでAIクライアントと通信し、UEプラグイン（C++実装）経由でエンジンに命令を送る。エンジン側の処理結果はプラグイン経由でPythonサーバーに返り、AIクライアントに届く。

ホスト型Flop MCPでは、ローカルのPythonサーバーが不要になり、クラウドのMCPエンドポイントに接続する。ただしUEプラグイン自体はローカルのUnreal Engine環境にインストールが必要だ。

セットアップ手順：ローカル版（Step-by-Step）

前提条件

• Unreal Engine 5.5以降
• Python 3.12以降
• MCP対応クライアント（Claude Desktop、Cursor、Windsurf等）

Option A：プリビルドプロジェクトを使う方法（推奨）

# リポジトリをクローン
git clone https://github.com/flopperam/unreal-engine-mcp.git
cd unreal-engine-mcp

クローン後、FlopperamUnrealMCP/FlopperamUnrealMCP.uprojectをダブルクリックまたはUnreal Engine Launcherから開く。プラグインは事前インストール済みのため追加作業不要だ。

Option B：既存プロジェクトにプラグインを追加

# プラグインをプロジェクトのPluginsフォルダにコピー
cp -r UnrealMCP/ YourProject/Plugins/

# Unreal Editorで有効化
# Edit → Plugins → "UnrealMCP"を検索 → Enable → エディタ再起動

Option C：全プロジェクトで使えるEngine Pluginsとしてインストール

# Engineのプラグインフォルダにコピー（全プロジェクトで利用可能）
cp -r UnrealMCP/ "C:/Program Files/Epic Games/UE_5.5/Engine/Plugins/"

MCPサーバーの起動

cd Python
uv run unreal_mcp_server_advanced.py

uvはPythonパッケージマネージャーで、pip install uvでインストールできる。

AIクライアントの設定

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unreal-engine-mcp/Python",
        "run",
        "unreal_mcp_server_advanced.py"
      ]
    }
  }
}

macOSでuvのパスが認識されない場合：uvの絶対パスを指定する。

# macOSでuvのパスを確認
which uv
# 例：/Users/username/.local/bin/uv

{
  "mcpServers": {
    "unrealMCP": {
      "command": "/Users/username/.local/bin/uv",
      "args": ["--directory", "/path/to/unreal-engine-mcp/Python", "run", "unreal_mcp_server_advanced.py"]
    }
  }
}

ホスト型Flop MCPのセットアップ（Pythonインストール不要）

最速でUnreal Engine MCPを始めたい場合はホスト型を選ぶ。

Step 1：APIキーの取得

flopperam.com/accountでアカウントを作成し、APIキーを発行する。

Step 2：UEプラグインのインストール

flopperam.com/docsのInstallationタブに従ってUEプラグインをインストールする。

Step 3：AIクライアントの設定

Claude Code：

claude mcp add -H "Authorization: Bearer YOUR_API_KEY" \
  --transport http flopperam-unreal https://agent.flopperam.com/mcp

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "flopperam-unreal": {
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline / ローカルLLM（Ollama、LM Studio等）：

{
  "mcpServers": {
    "flopperam-unreal": {
      "type": "streamableHttp",
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

設定後、IDEでサーバーが「接続済み」として表示されれば動作開始だ。

実践的なユースケース

ユースケース1：Blueprint健康システムの自動実装

プロンプト例：
「BP_MyPlayerにダメージ追跡と死亡イベントを持つ体力システムをBlueprintで実装して」

AIは以下の操作を自動実行する：

1. create_blueprintでBP_MyPlayerを作成（または既存Blueprintを開く）
2. create_variableでHealth（Float）、MaxHealth（Float）変数を追加
3. create_functionでTakeDamage関数を作成
4. add_nodeでBranch・VariableGet・VariableSetノードを追加
5. connect_nodesでノードを接続して実行フローを構成
6. compile_blueprintでコンパイルと検証

ユースケース2：大規模3Dシーンの高速構築

# AIに対する指示例
"""
中世の村を作って。
- 10x10の迷路で囲まれたエリア
- 中央に城塞
- 周囲に複数の家屋（マンション2棟、一般住宅5棟）
- 吊り橋で城塞へのアクセスを確保
"""

個別コマンドに分解すると：

create_maze(rows=10, cols=10, wall_height=4, cell_size=250)
create_castle_fortress(...)
construct_house(house_style="mansion", width=1200, height=800)
construct_house(house_style="standard", ...)  # ×5
create_suspension_bridge(...)

通常のエディタ操作では数時間かかる作業が、プロンプト1つで実行できる。

ユースケース3：既存Blueprintの解析と改善

プロンプト例：
「BP_EnemyAIのBlueprintを読み取って、実行フローを解説してから、
移動速度の変数をPublicに変更して」

read_blueprint_contentとanalyze_blueprint_graphで現状を解析し、set_blueprint_variable_propertiesで変数のpublicフラグを設定する。コード読解とリファクタリングをAIが一気通貫で実行する。

ユースケース4：マテリアルを使ったビジュアライゼーション

建築ビジュアライゼーションプロジェクトで、大量のアクターにマテリアルを一括適用する場面：

プロンプト例：
「シーン内のすべてのWall_Actorを検索して、
ConcreteTextureMaterialを適用して」

get_actors_in_levelでアクター一覧を取得し、名前フィルタで対象を絞り込み、apply_material_to_actorをループ実行する。

競合・代替ツールとの比較

UE5のAI支援開発ツールを他の選択肢と比較する。

Unreal Engine MCPの最大の差別化点は「エディタをAIが直接操作する」点にある。他の選択肢はコードやアセットの提案に留まるが、このMCPサーバーは実際にエンジン内の操作を自動実行する。

AIエージェントフレームワーク比較2026でも解説しているように、ツールを通じて外部システムを直接操作できるAIエージェントの実用性は急速に向上している。Unreal Engine MCPはそのゲーム開発特化版として位置付けられる。

よくある質問・つまずきポイント

Q: uv run unreal_mcp_server_advanced.pyを実行するとモジュール未検出エラーが出る

Pythonのバージョンが3.12以上であることを確認する。uvが正しくインストールされていない場合はpip install uvを実行する。Windowsではwhere uvでパスを確認し、絶対パスをmcp.jsonに設定する。

Q: Unreal EngineがMCPサーバーに接続できない

UEプラグインが正しく有効化されているか確認する（Edit → Plugins → “UnrealMCP”）。プラグインを有効化後にエディタの再起動が必要だ。ファイアウォールがローカルポートへの接続をブロックしていないかも確認する。

Q: Blueprintのコンパイルエラーが出る

compile_blueprintツールはコンパイル結果のエラーメッセージを返す。AIにそのエラーメッセージを渡して「このエラーを修正して」と追加指示を出せば、ノード接続の修正やピンタイプの変更を自動実行してくれる。

Q: 生成された3Dシーンのオブジェクトが重なってしまう

set_actor_transformツールで位置・回転・スケールを後から調整できる。初回生成後に配置を微調整する指示を追加で出すのが効率的なワークフローだ。

Q: UE5.4以前のプロジェクトでも使えますか？

ホスト型Flop MCPはUE5.5、5.6、5.7のみサポート。ローカル版もUE5.5以降が対象だ。それ以前のバージョンへの対応は現時点では提供されていない。

ゲーム開発ワークフローへのMCP統合：MCPサーバー開発の観点から

Unreal Engine MCPは、MCPサーバーの作り方2026完全ガイドで解説されているMCPアーキテクチャの実践例として参照できる。UEプラグイン（C++）がツールの実行主体となり、Pythonサーバーがプロトコル変換を担う二層構成は、外部SDKをMCPでラップする一般的なパターンだ。

ゲームエンジンのようなリアルタイムシステムとAIエージェントを統合する際の課題—状態管理、エラー回復、長期実行ツールのタイムアウト—の解決策がこのリポジトリのソースコードから学べる。

まとめ

Unreal Engine MCPは、GitHubスター823のMCPサーバーで、自然言語によるUE5のBlueprint実装・3Dシーン構築・アクター管理を実現する。ローカル版はPython 3.12+とUE5.5+が必要で、セットアップには30〜60分程度かかる。ホスト型Flop MCPはURLとAPIキーだけで始められ、Python環境が不要だ。

プロトタイプの検証速度が最も効果を発揮する場面で威力を発揮する。「実装の意図はあるが、Blueprintに落とし込む翻訳コストが高い」という場面で、AIが直接エンジンを操作することでそのコストを削減できる。

参照ソース

• flopperam/unreal-engine-mcp - GitHub
• Flop MCP 公式サイト
• Flop MCP ドキュメント
• Unreal Engine 公式ドキュメント
• Blueprint Graph Programming Guide - リポジトリ内