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

この記事ではMCPに特化して解説します。MCP（Model Context Protocol）全般は MCPサーバーの作り方2026年完全ガイド：TypeScript・Python両対応チュートリアル をご覧ください。

Unreal Engine MCPは「作りたいシーンのイメージはあるのに、Blueprintに落とし込む作業が重い」を解決する。AIクライアントに日本語で指示すると、Unreal Engine 5のエディタが実際に動いてBlueprintノードを組み、3Dワールドを構築する。

Unreal Engine MCPとは何か：AIがエディタを直接操作するゲーム開発ツール

UE開発で時間を食うのは、「こういう挙動を実装したい」という意図をBlueprint上の構成に翻訳する工程だ。ノードを1つずつ置き、ピンをつなぎ、変数を宣言し、コンパイルエラーを潰す。Unreal Engine MCPは、AIクライアント（Cursor、Claude Code、Windsurf等）とUnreal Engineエディタを直接つなぎ、「キャラクターに体力システムを実装して」という指示をノード作成・変数設定・接続という操作として実行する。

・何ができるのか：Blueprintの視覚スクリプティング、3Dワールド・建築物の生成、既存Blueprintの読解、マテリアル/物理設定
・何を解決するのか：意図をBlueprintに落とし込む翻訳コスト
・何を代替するのか：手作業のノード配置・接続、ドキュメントを読みながらのAPI調査、プロトタイプ用のシーン組み立て

リポジトリは2025年8月公開。README末尾には「MIT License — Build amazing things freely.」とあるが、リポジトリ直下にLICENSEファイルが無い（GitHubのライセンスAPIは404）。業務でフォークするなら確認しておきたい。

Unreal Engine MCPの2つの使い方：ローカルOSS版とホスト型Flop MCP

リポジトリには名前が同じで中身の違う2つのプロダクトがあり、READMEは「ホスト型Flop MCPはローカルのPython/サーバーとコードを一切共有しない、まったく別のはるかに高機能なサーバー」と明記している。

ローカル方式では、PythonサーバーがstdioでAIクライアントと話し、TCPソケットでUnrealMCPプラグイン（C++・本リポジトリのUnrealMCP/に同梱）にコマンドを送る。ホスト型ではローカルのPythonサーバーが要らず、クライアントはStreamable HTTPでクラウドのエンドポイントにつなぎ、サーバーはWebSocketでFlopAIプラグインと通信する。ただしFlopAIはローカルのUnreal Engineに入れる必要がある（flopperam.com/unreal-agentから導入。UnrealMCPとは別物）。どちらもUE5.5/5.6/5.7のエディタに届く。

無料で手元で試すならローカル版、本格的にAIでUE開発を進めるならホスト型、という住み分けだ。

Unreal Engine MCPでできること：ローカル版のツールとホスト型の50+ツール

ローカルOSS版のツール

ホスト型Flop MCPの50+ツール

9ドメインにまたがる50以上のツールを、狭く分割された（narrow）バッチ設計で提供する。

決定的な差はPIE（Play In Editor）ランタイム検証だ。pie_test_bp／pie_test_sceneは30種類以上のアサーションでBlueprintやシーンを実行時にテストでき、AIが作ったものをAI自身が「動くか」まで確かめる。公式デモでは単一プロンプトから4,000以上のオブジェクトを持つ都市が生成されている。

セットアップ手順：ローカルOSS版とホスト型Flop MCP

ローカルOSS版（UE5.5+・Python 3.12+）

git clone https://github.com/flopperam/unreal-engine-mcp.git
cd unreal-engine-mcp
cp -r UnrealMCP/ YourProject/Plugins/

Unreal Editorで Edit → Plugins → "UnrealMCP" を有効にして再起動する。全プロジェクトで使うならEngineのPluginsフォルダ（例：C:/Program Files/Epic Games/UE_5.5/Engine/Plugins/）に置く。次にAIクライアント（例：Cursorの.cursor/mcp.json）にサーバーを登録する。uvはpip install uvで入り、パスが認識されなければwhich uv（Windowsはwhere uv）の絶対パスを書く。

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

macOSでXcode 16以降を使うとUE5.5プロジェクトでコンパイルエラーが出ることがあり、Apple_SDK.jsonのMaxVersionとLLVMバージョンの対応を更新する必要がある。手順はリポジトリのLOCAL_SETUP.mdとDEBUGGING.mdにある。

ホスト型Flop MCP（Python不要）

flopperam.com/accountでAPIキーを発行し、flopperam.com/docsのInstallationタブに従ってFlopAIプラグインを入れる。Claude Codeなら接続は1行だ。

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

Cursorは.cursor/mcp.json、VS Code/Copilotは.vscode/mcp.json、Cline/ローカルLLM（Ollama、LM Studio等）はtype: streamableHttpを指定する。どれもURLとAuthorizationヘッダーの2項目だけだ。

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

ユースケースと競合比較：AIが何を代替するのか

Blueprintの体力システム：「BP_MyPlayerにダメージ追跡と死亡イベントを持つ体力システムを実装して」と頼むと、create_blueprint → create_variable（Health／MaxHealth）→ create_function（TakeDamage）→ add_node・connect_nodes（Branch・VariableGet・VariableSet）→ compile_blueprint と進む。

大規模シーン：「10x10の迷路で囲まれたエリア、中央に城塞、周囲にマンション2棟と住宅5棟、吊り橋で城塞へ」は、create_maze・create_castle_fortress・construct_house・create_suspension_bridgeの連鎖に分解されて実行される。

既存Blueprintの解析：「BP_EnemyAIの実行フローを解説してから、移動速度の変数をPublicに」なら、read_blueprint_contentとanalyze_blueprint_graphで読み、set_blueprint_variable_propertiesで変える。ホスト型のFlop Agentはタスクごとにモデルを振り分け（推論にOpus、ルックアップにFlashなど）、公式チャンネルにはGPT-5とClaudeを同時に走らせるビルドバトル動画もある。

他の選択肢はコードやアセットの提案にとどまるが、Unreal Engine MCPはエディタ内の操作を実行し、ホスト型はPIEで動作の検証までする。同じ発想のUnity版は mcp-unity：MCPサーバー 作り方でUnity開発をClaude・CursorのAIと直接連携するプラグイン で扱っており、エンジン側プラグイン＋MCPサーバーという二層構成もほぼ同じだ。ほかのMCPサーバーと併用して設定が膨らんだら、MCPJungle徹底解説｜散らばるMCPサーバーを1本に束ねる自己ホスト型MCPゲートウェイ のようなゲートウェイで束ねる手もある。

つまずきポイントと、MCPサーバー設計としての見どころ

詰まったらLOCAL_SETUP.md・DEBUGGING.mdと公式Discord（discord.gg/3KNkke3rnH）にあたる。

MCPサーバーの作り方2026年完全ガイド：TypeScript・Python両対応チュートリアルの観点で見ると、エンジン側プラグイン（C++）がツールの実行主体で、サーバーがプロトコル変換を担う二層構成は、外部SDKやリアルタイムシステムをMCPでラップする典型だ。ホスト型のbp_create・bp_variable・bp_wire・bp_commitのように工程ごとにツールを分け、それぞれにLLM向けのガイダンスとエラー回復を持たせる「narrow tools＋バッチ実行」は、LLMがツールを取り違えにくくする設計として参考になる。まずは無料のローカル版で「AIがエディタを動かす」感覚を掴み、本格運用ではホスト型に移る、という導線が現実的だ。

参照ソース

• flopperam/unreal-engine-mcp - GitHub
• Aura（Flopperam買収先） - tryaura.dev
• Flop MCP / Flopperam 公式サイト
• Flop MCP ドキュメント
• Complete MCP Tutorial & Installation Guide - Flopperam YouTube
• Unreal Engine 公式ドキュメント