# Unreal Mcp Pro Plugin

> UE5.7 C++ editor plugin for AI-assisted Unreal Engine development via Model Context Protocol (MCP). 200+ tools across 39 categories.

- **Type:** MCP server
- **Install:** `agentstack add mcp-youichi-uda-unreal-mcp-pro-plugin`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [youichi-uda](https://agentstack.voostack.com/s/youichi-uda)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [youichi-uda](https://github.com/youichi-uda)
- **Source:** https://github.com/youichi-uda/unreal-mcp-pro-plugin
- **Website:** https://y1uda.itch.io/unreal-mcp-pro

## Install

```sh
agentstack add mcp-youichi-uda-unreal-mcp-pro-plugin
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)](https://modelcontextprotocol.io/). 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](https://y1uda.itch.io/unreal-mcp-pro))
- 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
   ```

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

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

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

5. **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

```json
// 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)](https://modelcontextprotocol.io/) を通じて、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](https://y1uda.itch.io/unreal-mcp-pro) からダウンロード）
- Node.js 18+（MCP サーバー用）

## インストール

1. このリポジトリをプロジェクトの `Plugins` フォルダにクローンまたはダウンロード:
   ```
   YourProject/
   └── Plugins/
       └── UnrealMCPPro/
           ├── Source/
           └── UnrealMCPPro.uplugin
   ```

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

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

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

5. 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](https://github.com/youichi-uda)
- **Source:** [youichi-uda/unreal-mcp-pro-plugin](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-youichi-uda-unreal-mcp-pro-plugin
- Seller: https://agentstack.voostack.com/s/youichi-uda
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.