1. Install The Plugin

Clone the open-source plugin into your Unreal project:

cd D:\UE5Project\YourProject
mkdir Plugins
cd Plugins
git clone https://github.com/winyunq/UnrealMotionGraphicsMCP.git UmgMcp

Open the project in Unreal Engine 5.8, enable UmgMcp if needed, and restart the editor so Unreal Build Tool can compile the plugin.

3. Verify The Setup

Run protocol checks without opening a large test scenario:

cd D:\UE5Project\YourProject\Plugins\UmgMcp\Resources\Python
uv run python APITest\Umg_Widget_Protocol_Static_Check.py
uv run python APITest\Blueprint_MCP_Schema_Check.py
uv run python APITest\Material_Protocol_Static_Check.py
uv run python APITest\Animation_Protocol_Static_Check.py

Run an editor bridge smoke test after Unreal Editor is open:

uv run python APITest\UE5_Editor_Imitation.py

If you want a manual virtual environment:

cd D:\UE5Project\YourProject\Plugins\UmgMcp\Resources\Python
uv venv
.\.venv\Scripts\activate
uv pip install "mcp[cli]>=1.4.1" fastmcp uvicorn fastapi "pydantic>=2.6.1" requests
python -c "import mcp, fastapi, pydantic, requests; print('deps ok')"

Quick Start

Current target: Unreal Engine 5.8 on Win64. The plugin descriptor is set to EngineVersion: 5.8.0.

Example Agent Request

Create /Game/UI/WBP_LoginPanel with a centered login card, email and password fields,
a primary submit button, and a subtle material background. Export the final widget JSON
and summarize which MCP tools changed the asset.

Usage Tips

Prompts are crucial for AI tool effectiveness. Use the Prompt Manager to tailor the AI's behavior:

• One-Click Deployment Mode: If you want the AI to focus solely on generating UI from design, disable all tools except apply_layout and export_umg_to_json.
• Tutor Mode: If you want the AI to guide you without making changes, keep only read-only tools (e.g., get_widget_tree, get_widget_schema).
• Context Optimization: For models with smaller context windows, disable tools you aren't currently using to improve speed and accuracy.

Contributions of effective prompt configurations are welcome!

</details>

---

<details> <summary>🏗️ Current Technical Architecture</summary>

The system now primarily relies on the UE5_UMG_MCP plugin for communication between external clients (like this CLI) and the Unreal Engine Editor.

Architecture Diagram:

</details>

---

<details> <summary>⚖️ AI Authorship &amp; Disclaimer</summary>

This project has been developed with significant assistance from Gemini, an AI. As such: Experimental Nature: This is an experimental project. Its reliability is not guaranteed. Commercial Use: Commercial use is not recommended without thorough independent validation and understanding of its limitations. * Disclaimer: Use at your own risk. The developers and AI are not responsible for any consequences arising from its use.

</details>

---

Demos

• Designing an RTS UI
• Recreating the UE5 editor
• Editing UMG inside the UMG editor
• Chatting with Gemini to edit a UMG file

UMG Widget API Status

Notes: - UMG writes are append/upsert style: create_widget creates missing widgets and set_widget_properties only overwrites supplied properties. - Deletion is explicit and hardened: delete_widget fails unless confirm_delete=true is supplied.

UMG Blueprint API Status (Transitional)

Blueprint MCP is still node-shaped. It is usable for simple event wiring, but it is not the final high-density bluecode protocol described in Document/BlueprintBluecodeProtocol.md.

Notes: - Current Blueprint reads are not yet semantically dense enough to answer "read any information" well. - bluecode should introduce code-like read/write, append-only merge semantics, explicit bluecode_delete(confirm_delete=true), and compact compile diagnostics. - Until then, use Blueprint MCP only for narrow event wiring and verify with compile_blueprint plus focused readback.

UMG Sequencer API Status

Notes: - set_animation_scope/set_widget_scope implement the target/default semantics from the protocol; names are auto-corrected (no "animal" typo) and animations auto-create when missing. - Write paths are union/overwrite only—no implicit deletion. Use animation_delete_widget_keys with confirm_delete=true for scoped removals. - Legacy low-level reads/writes such as get_animation_keyframes, get_animation_full_data, set_property_keys, set_animation_data, remove_property_track, and remove_keys remain backend compatibility commands but are hidden from the default MCP prompt surface. - Responses include counts/timeline context so every default Sequencer MCP returns actionable data.

UMG Material API Status

UMG Style & Theming API Status (New)

---

Troubleshooting