Unreal Mcp Pro Plugin

UnrealMCPPro - Unreal Engine 5 MCP Plugin

AI-Powered Unreal Engine Development via Model Context Protocol

Installation | Features | Tool Catalog | Architecture | License

日本語

---

UnrealMCPPro is a C++ editor plugin for Unreal Engine 5.7 that enables AI assistants (Claude, GPT, etc.) to directly control the Unreal Editor through the Model Context Protocol (MCP). It provides 200+ command handlers across 39 categories, covering nearly every aspect of UE5 development — from spawning actors and creating materials to managing Blueprints, Niagara systems, and Level Sequences.

Key Benefits

• AI-Assisted Level Design — Spawn actors, set transforms, assign materials, and build entire scenes through natural language
• Automated Workflows — Create Blueprints, compile, set variables, and manage assets without touching the editor UI
• Full Editor Control — Play/Stop PIE, capture viewports, execute console commands, undo/redo operations
• Production-Ready — WebSocket-based communication with auto-reconnect, JSON-RPC 2.0 protocol, and robust error handling

Requirements

• Unreal Engine 5.7+
• A compatible MCP server (included with the itch.io download)
• Node.js 18+ (for the MCP server)

Installation

1. Clone or download this repository into your project's Plugins folder:

`` YourProject/ └── Plugins/ └── UnrealMCPPro/ ├── Source/ └── UnrealMCPPro.uplugin ``

1. Regenerate project files — Right-click your .uproject file and select "Generate Visual Studio project files"

1. Build the project in Visual Studio (Development Editor configuration)

1. Launch the Unreal Editor — the plugin loads automatically at engine startup

1. Start the MCP server and configure your AI assistant to connect via MCP

How It Works

AI Assistant (Claude/GPT)
        ↕ MCP Protocol (stdio)
   MCP Server (Node.js)
        ↕ WebSocket (JSON-RPC 2.0, port 6705-6709)
   UnrealMCPPro Plugin
        ↕ Unreal Editor C++ API
   Unreal Engine 5.7

The plugin runs a WebSocket client that connects to the MCP server. Commands arrive as JSON-RPC 2.0 requests, get dispatched to the appropriate handler, execute Unreal Editor API calls, and return structured JSON results.

Features

39 Command Categories

| Category | Tools | Description | |----------|-------|-------------| | Actor | 11 | Spawn, delete, find, rename, duplicate, select, tag, group actors | | Transform | 5 | Set/get world & relative transforms, mobility, snap to ground | | Component | 6 | Add, remove, list components, get/set properties | | Blueprint | 6 | Create, compile, add components, set defaults, add variables | | Material | 6 | Create materials & instances, set parameters, assign to actors | | Material Editor | 5 | Add/connect expression nodes, set values, inspect graphs | | Lighting | 6 | Add lights (point/spot/directional/rect), Lumen settings, skylight | | Level | 6 | Load, save, create levels, get world outliner | | Editor | 6 | PIE play/stop, console commands, output log, focus viewport | | Viewport | 5 | Camera control, view modes, focus on actor, screenshot capture | | Asset | 6 | Find, import, export, delete, rename content assets | | Static Mesh | 5 | Import meshes, LOD settings, collision, Nanite | | Skeletal Mesh | 5 | Import, skeleton info, sockets, physics assets | | Animation | 6 | Import animations, create AnimBP, blend spaces, montages | | Physics | 5 | Simulation, constraints, collision presets & responses | | Landscape | 6 | Create, sculpt, paint layers, import heightmaps | | Foliage | 4 | Add types, paint, remove, inspect foliage | | Niagara | 6 | Create systems/emitters, set parameters, activate | | Sequencer | 7 | Create sequences, add tracks/keyframes, bind actors | | Audio | 5 | Add audio components, sound cues, MetaSound, attenuation | | AI | 6 | Behavior trees, blackboards, EQS | | Navigation | 4 | Build nav mesh, settings, modifiers, path testing | | PCG | 5 | Create graphs, add nodes, generate procedural content | | UI | 5 | Create widget BPs, add children, set properties/bindings | | Input | 5 | Enhanced Input actions, mapping contexts, triggers | | Gameplay | 4 | Gameplay tags, GAS abilities & effects | | Rendering | 6 | Post-process volumes, Nanite, Lumen GI, Virtual Shadow Maps | | Optimization | 4 | Scene stats, texture stats, scalability, profiling | | Debug | 3 | Console log, console commands, stat queries | | Batch | 3 | Batch spawn, set properties, transform multiple actors | | Python | 3 | Execute Python scripts, run script files | | Build | 4 | Light maps, cook content, package project | | Testing | 4 | List/run automation tests, functional tests | | Undo | 3 | Undo, redo, get undo history | | Source Control | 4 | Status, checkout, revert, changelist | | Plugin | 3 | Plugin info, enable/disable | | Project | 5 | Project info, settings, engine version | | World Partition | 4 | Partition info, data layers, region loading | | Data Asset | 5 | Data tables, data assets, curves |

Tool Catalog

Click to expand full tool list (200+ tools)

Actor Tools

• spawn_actor — Spawn an actor by class with location/rotation
• delete_actor — Delete an actor by label
• rename_actor — Rename an actor
• find_actors — Search actors by name, class, or tag
• get_actor_info — Get detailed actor information
• select_actor — Select actor in the editor
• duplicate_actor — Duplicate with offset
• move_actor — Move to a new location
• set_actor_tag — Add/remove tags
• set_actor_visibility — Show/hide actors
• group_actors — Group multiple actors

Transform Tools

• get_transform / set_transform — World transform
• set_relative_transform — Relative to parent
• set_mobility — Static/Stationary/Movable
• snap_to_ground — Snap actor to ground surface

Blueprint Tools

• create_blueprint — Create new Blueprint asset
• compile_blueprint — Compile a Blueprint
• get_blueprint_info — Inspect Blueprint details
• add_blueprint_component — Add component to BP
• set_blueprint_default — Set default property values
• create_blueprint_variable — Add variables

Material Tools

• create_material / create_material_instance — Create materials
• set_material_parameter — Set scalar/vector/texture parameters
• assign_material — Assign material to actor
• get_material_info / list_materials — Inspect materials

Editor & Viewport Tools

• play_in_editor / stop_pie / get_play_state — PIE control
• execute_console_command — Run console commands
• get_output_log — Read editor log
• get_viewport_info / set_viewport_camera — Camera control
• set_view_mode — Lit/Unlit/Wireframe/PathTracing
• focus_on_actor — Focus viewport on actor
• capture_viewport — Take screenshots

Asset Tools

• find_assets — Search content browser
• get_asset_info — Asset details and disk size
• import_asset / export_asset — Import/export
• delete_asset / rename_asset — Manage assets

...and 140+ more tools across all categories

Architecture

Connection Protocol

• Transport: WebSocket (ports 6705-6709, auto-discovery)
• Protocol: JSON-RPC 2.0
• Reconnection: Automatic, 3-second interval
• Concurrency: Multiple MCP servers supported via port range

Request/Response Format

// Request (MCP Server → Plugin)
{
  "jsonrpc": "2.0",
  "method": "spawn_actor",
  "params": { "class": "PointLight", "label": "MyLight", "x": 0, "y": 0, "z": 300 },
  "id": "uuid"
}

// Response (Plugin → MCP Server)
{
  "jsonrpc": "2.0",
  "id": "uuid",
  "result": {
    "success": true,
    "data": { "actor_label": "MyLight", "class": "PointLight" }
  }
}

Module Dependencies

The plugin integrates with 30+ Unreal Engine modules including:

• Core: UnrealEd, Slate, BlueprintGraph, Kismet
• Rendering: MaterialEditor, Niagara, LevelSequence
• Gameplay: AIModule, NavigationSystem, GameplayTags, EnhancedInput
• Tools: AssetTools, AutomationController, SourceControl, PCG

Links

• Download (itch.io): https://y1uda.itch.io/unreal-mcp-pro

Contributing

Contributions are welcome! Please open an issue or pull request.

License

MIT License - see [LICENSE](LICENSE) for details.

---

UnrealMCPPro - Unreal Engine 5 MCP プラグイン

Model Context Protocol による AI 駆動の Unreal Engine 開発

インストール | 機能一覧 | アーキテクチャ

English

---

UnrealMCPPro は、Unreal Engine 5.7 用の C++ エディタプラグインです。Model Context Protocol (MCP) を通じて、AI アシスタント（Claude、GPT など）が Unreal Editor を直接操作できるようにします。39 カテゴリ、200 以上のコマンドハンドラを提供し、アクターの配置からマテリアル作成、ブループリント管理、Niagara システム、レベルシーケンスまで、UE5 開発のほぼ全ての領域をカバーします。

主な特長

• AI によるレベルデザイン — 自然言語でアクター配置、トランスフォーム設定、マテリアル割り当て、シーン構築
• ワークフロー自動化 — ブループリント作成・コンパイル、変数設定、アセット管理を UI 操作なしで実行
• 完全なエディタ制御 — PIE 再生/停止、ビューポートキャプチャ、コンソールコマンド実行、Undo/Redo
• プロダクション品質 — WebSocket 通信、自動再接続、JSON-RPC 2.0 プロトコル、堅牢なエラーハンドリング

必要環境

• Unreal Engine 5.7 以上
• 対応する MCP サーバー（itch.io からダウンロード）
• Node.js 18+（MCP サーバー用）

インストール

1. このリポジトリをプロジェクトの Plugins フォルダにクローンまたはダウンロード:

`` YourProject/ └── Plugins/ └── UnrealMCPPro/ ├── Source/ └── UnrealMCPPro.uplugin ``

1. .uproject ファイルを右クリック → 「Generate Visual Studio project files」を選択

1. Visual Studio でビルド（Development Editor 構成）

1. Unreal Editor を起動（プラグインはエンジン起動時に自動ロード）

1. MCP サーバーを起動し、AI アシスタントから MCP 経由で接続

動作の仕組み

AI アシスタント (Claude/GPT)
        ↕ MCP プロトコル (stdio)
   MCP サーバー (Node.js)
        ↕ WebSocket (JSON-RPC 2.0, ポート 6705-6709)
   UnrealMCPPro プラグイン
        ↕ Unreal Editor C++ API
   Unreal Engine 5.7

機能一覧

39 のコマンドカテゴリ

| カテゴリ | ツール数 | 説明 | |---------|---------|------| | アクター | 11 | スポーン、削除、検索、リネーム、複製、選択、タグ、グループ | | トランスフォーム | 5 | ワールド/相対トランスフォーム、モビリティ、地面スナップ | | コンポーネント | 6 | 追加、削除、一覧、プロパティ取得/設定 | | ブループリント | 6 | 作成、コンパイル、コンポーネント追加、デフォルト値設定、変数追加 | | マテリアル | 6 | マテリアル/インスタンス作成、パラメータ設定、アクターへの割り当て | | マテリアルエディタ | 5 | エクスプレッションノード追加/接続、値設定、グラフ取得 | | ライティング | 6 | ライト追加、Lumen 設定、スカイライト | | レベル | 6 | ロード、保存、新規作成、ワールドアウトライナー | | エディタ | 6 | PIE 再生/停止、コンソールコマンド、出力ログ | | ビューポート | 5 | カメラ制御、ビューモード、フォーカス、スクリーンショット | | アセット | 6 | 検索、インポート、エクスポート、削除、リネーム | | スタティックメッシュ | 5 | インポート、LOD、コリジョン、Nanite | | スケルタルメッシュ | 5 | インポート、スケルトン情報、ソケット | | アニメーション | 6 | インポート、AnimBP 作成、ブレンドスペース、モンタージュ | | フィジックス | 5 | シミュレーション、コンストレイント、コリジョン | | ランドスケープ | 6 | 作成、スカルプト、レイヤーペイント、ハイトマップ | | フォリッジ | 4 | タイプ追加、ペイント、削除 | | Niagara | 6 | システム/エミッター作成、パラメータ設定 | | シーケンサー | 7 | シーケンス作成、トラック/キーフレーム追加 | | オーディオ | 5 | オーディオコンポーネント、サウンドキュー、MetaSound | | AI | 6 | ビヘイビアツリー、ブラックボード、EQS | | ナビゲーション | 4 | ナビメッシュビルド、設定、パステスト | | PCG | 5 | グラフ作成、ノード追加、プロシージャル生成 | | UI | 5 | ウィジェット BP 作成、子要素追加、プロパティ設定 | | インプット | 5 | Enhanced Input アクション、マッピングコンテキスト | | ゲームプレイ | 4 | ゲームプレイタグ、GAS アビリティ/エフェクト | | レンダリング | 6 | ポストプロセス、Nanite、Lumen GI、Virtual Shadow Maps | | 最適化 | 4 | シーン統計、テクスチャ統計、スケーラビリティ | | デバッグ | 3 | コンソールログ、コマンド、統計クエリ | | バッチ | 3 | 一括スポーン、プロパティ設定、トランスフォーム | | Python | 3 | Python スクリプト実行 | | ビルド | 4 | ライトマップ、クック、パッケージ | | テスト | 4 | オートメーションテスト実行/結果取得 | | Undo | 3 | 元に戻す、やり直し、履歴取得 | | ソースコントロール | 4 | ステータス、チェックアウト、リバート | | プラグイン | 3 | プラグイン情報、有効化/無効化 | | プロジェクト | 5 | プロジェクト情報、設定、エンジンバージョン | | ワールドパーティション | 4 | パーティション情報、データレイヤー | | データアセット | 5 | データテーブル、データアセット、カーブ |

アーキテクチャ

接続プロトコル

• 通信方式: WebSocket（ポート 6705-6709、自動ディスカバリ）
• プロトコル: JSON-RPC 2.0
• 再接続: 自動（3 秒間隔）
• 同時接続: ポート範囲による複数 MCP サーバー対応

リンク

• ダウンロード (itch.io): https://y1uda.itch.io/unreal-mcp-pro

ライセンス

MIT License - 詳細は [LICENSE](LICENSE) を参照してください。

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: youichi-uda
• Source: youichi-uda/unreal-mcp-pro-plugin
• License: MIT
• Homepage: https://y1uda.itch.io/unreal-mcp-pro

Install and usage instructions live in the source repository linked above.