Skip to content
Back to search

UnrealMotionGraphicsMCP

🚀 UE5-UMG-MCP: A deep-focused MCP for Unreal Engine UMG layout. Designed to maximize AI efficiency within limited context windows by prioritizing precision in UI structure, animations, and blueprint integration.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/winyunq--unrealmotiongraphicsmcp/badge.svg)](/listings/winyunq--unrealmotiongraphicsmcp)

HTML

<a href="/listings/winyunq--unrealmotiongraphicsmcp"><img src="/api/listings/winyunq--unrealmotiongraphicsmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

UMG MCP currently targets **Unreal Engine 5.8 on Win64**. The plugin descriptor in this package is set to `EngineVersion: 5.8.0`.

Option A: Fab Edition

Use this if you want the shortest install path and the in-editor workflow.

1. Open the [Fab Marketplace listing](https://www.fab.com/zh-cn/listings/f70dbcb0-11e4-46bf-b3f7-9f30ba2c9b71). 2. Add the plugin to your Epic Games / Unreal Engine library. 3. Install it for Unreal Engine 5.8. 4. Open your project, enable `UmgMcp`, then restart the editor. 5. Open the plugin settings and configure your model provider. The web manual covers Google OAuth, Gemini API, ZhipuAI, and OpenAI-compatible endpoints.

Option B: Source Edition

Use this if you want to inspect the protocol, develop fixes, or integrate the plugin manually.

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

Then open the project in Unreal Engine 5.8 and allow Unreal Build Tool to compile the plugin. If you move the plugin between projects, keep the final folder name as `UmgMcp` unless you also update your MCP client configuration.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

Readme.md · README · 200 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [中文版](Readme_zh.md)
  2. <div align="center">
  3. <img src="Resources/Icon128.png" width="96" alt="UMG MCP logo">
  4. <h1>UMG MCP for Unreal Engine 5.8</h1>
  5. <p><strong>Build, inspect, refactor, and version UMG UI through AI agents and MCP tools.</strong></p>
  6. <p>
  7. <a href="https://winyunq.github.io/UnrealMotionGraphicsMCP/">Web Manual</a>
  8. · <a href="#install">Install</a>
  9. · <a href="#connect-an-mcp-client">MCP Client</a>
  10. · <a href="https://www.fab.com/zh-cn/listings/f70dbcb0-11e4-46bf-b3f7-9f30ba2c9b71">Fab Marketplace</a>
  11. · <a href="https://discord.gg/yk5VEQ5S9U">Discord</a>
  12. </p>
  13. <p>
  14. <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg">
  15. <img alt="Unreal Engine 5.8" src="https://img.shields.io/badge/UE-5.8-0E1128.svg?logo=unrealengine">
  16. <img alt="Platform Win64" src="https://img.shields.io/badge/Platform-Win64-2563EB.svg">
  17. <a href="https://agentseal.org/mcp/https-githubcom-winyunq-unrealmotiongraphicsmcp"><img alt="AgentSeal MCP" src="https://agentseal.org/api/v1/mcp/https-githubcom-winyunq-unrealmotiongraphicsmcp/badge"></a>
  18. </p>
  19. </div>
  20. ---
  21. UMG MCP turns Unreal Editor UMG work into explicit, reviewable tool calls. An AI agent can create widgets, update layout, wire Blueprint logic, edit materials, drive UMG animation, and round-trip UI files through JSON instead of relying on screenshots or fragile click automation.
  22. The README is the front door. The step-by-step tutorials live in the deployed documentation site:
  23. <table>
  24. <tr>
  25. <td><strong>Start here</strong></td>
  26. <td><a href="https://winyunq.github.io/UnrealMotionGraphicsMCP/">Open the web manual</a></td>
  27. </tr>
  28. <tr>
  29. <td><strong>Repository copy</strong></td>
  30. <td><a href="Document/index.html">Document/index.html</a> and <a href="Document/index_zh.html">Document/index_zh.html</a></td>
  31. </tr>
  32. </table>
  33. ## Why It Exists
  34. | Problem in normal AI UI work | UMG MCP approach |
  35. | --- | --- |
  36. | Agents guess from screenshots | Agents read the actual widget tree, slots, properties, materials, and graph state |
  37. | UI edits are hard to diff | UMG can be exported, patched, and re-applied as structured JSON |
  38. | Blueprint wiring is click-heavy | BlueCode and MCP commands create nodes, pins, references, and links directly |
  39. | Long chat history wastes context | Fab edition adds production packaging and context-management work for larger sessions |
  40. ## Blueprint API Status (Transitional)
  41. BlueCode now separates attention-compressed semantic reads from round-trip/debug evidence. Union writes support graph revisions, source maps, dry-run plans, LCS right-anchor insertion, safe append, and rollback on failure. It is still transitional: complete structured CFG recovery and editing for nested branches, loops, Sequence/Switch, latent nodes, and arbitrary irreducible graphs remains v2 work. Low-level node commands are compatibility execution primitives, not the BlueCode language.
  42. ## Install
  43. UMG MCP currently targets **Unreal Engine 5.8 on Win64**. The plugin descriptor in this package is set to `EngineVersion: 5.8.0`.
  44. ### Option A: Fab Edition
  45. Use this if you want the shortest install path and the in-editor workflow.
  46. 1. Open the [Fab Marketplace listing](https://www.fab.com/zh-cn/listings/f70dbcb0-11e4-46bf-b3f7-9f30ba2c9b71).
  47. 2. Add the plugin to your Epic Games / Unreal Engine library.
  48. 3. Install it for Unreal Engine 5.8.
  49. 4. Open your project, enable `UmgMcp`, then restart the editor.
  50. 5. Open the plugin settings and configure your model provider. The web manual covers Google OAuth, Gemini API, ZhipuAI, and OpenAI-compatible endpoints.
  51. ### Option B: Source Edition
  52. Use this if you want to inspect the protocol, develop fixes, or integrate the plugin manually.
  53. ```powershell
  54. cd D:\UE5Project\YourProject
  55. mkdir Plugins
  56. cd Plugins
  57. git clone https://github.com/winyunq/UnrealMotionGraphicsMCP.git UmgMcp
  58. ```
  59. Then open the project in Unreal Engine 5.8 and allow Unreal Build Tool to compile the plugin. If you move the plugin between projects, keep the final folder name as `UmgMcp` unless you also update your MCP client configuration.
  60. ## Connect An MCP Client
  61. External MCP clients use the Python server under `Resources/Python`. Each Unreal Editor instance binds an OS-assigned local port and publishes it to the shared UmgMcp discovery registry. With one editor, the Python front end selects it automatically; with several editors, use `list_umg_mcp_servers` and `connect_umg_mcp` to choose the project.
  62. Add this to the `mcpServers` section of your client settings, replacing the path with your own absolute plugin path:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "UmgMcp": {
  67. "command": "uv",
  68. "args": [
  69. "run",
  70. "--directory",
  71. "D:\\UE5Project\\YourProject\\Plugins\\UmgMcp\\Resources\\Python",
  72. "UmgMcpServer.py"
  73. ]
  74. }
  75. }
  76. }
  77. ```
  78. Notes:
  79. - The path must point to `Resources/Python`, not the repository root.
  80. - On Windows JSON paths need escaped backslashes: `D:\\Path\\To\\Project`.
  81. - If `uv` is missing, install it first or create the optional virtual environment below.
  82. Optional local Python setup:
  83. ```powershell
  84. cd D:\UE5Project\YourProject\Plugins\UmgMcp\Resources\Python
  85. uv venv
  86. .\.venv\Scripts\activate
  87. uv pip install "mcp[cli]>=1.4.1" fastmcp uvicorn fastapi "pydantic>=2.6.1" requests
  88. python -c "import mcp, fastapi, pydantic, requests; print('deps ok')"
  89. ```
  90. ## Verify The Setup
  91. Run static protocol checks without opening a project:
  92. ```powershell
  93. cd D:\UE5Project\YourProject\Plugins\UmgMcp\Resources\Python
  94. uv run python APITest\Umg_Widget_Protocol_Static_Check.py
  95. uv run python APITest\Blueprint_MCP_Schema_Check.py
  96. uv run python APITest\Material_Protocol_Static_Check.py
  97. uv run python APITest\Animation_Protocol_Static_Check.py
  98. ```
  99. Run an editor smoke test after Unreal Editor is open:
  100. ```powershell
  101. uv run python APITest\UE5_Editor_Imitation.py
  102. ```
  103. If the editor-side test cannot connect, check that the plugin is enabled and use `list_umg_mcp_servers` to confirm its dynamically assigned endpoint is discoverable.
  104. ## Documentation Map
  105. | Goal | Web page | Repository file |
  106. | --- | --- | --- |
  107. | Set up model providers | [Model configuration](https://winyunq.github.io/UnrealMotionGraphicsMCP/Document/model_config.html) | [Document/model_config.html](Document/model_config.html) |
  108. | Use the in-editor chat workflow | [Chat dialogue guide](https://winyunq.github.io/UnrealMotionGraphicsMCP/Document/chat_dialogue.html) | [Document/chat_dialogue.html](Document/chat_dialogue.html) |
  109. | Understand MCP support | [MCP support](https://winyunq.github.io/UnrealMotionGraphicsMCP/Document/mcp_support.html) | [Document/mcp_support.html](Document/mcp_support.html) |
  110. | Widget command protocol | - | [Document/UmgWidgetMcpProtocol.md](Document/UmgWidgetMcpProtocol.md) |
  111. | Blueprint / BlueCode protocol | - | [Document/BlueprintBluecodeProtocol.md](Document/BlueprintBluecodeProtocol.md) |
  112. | Material and HLSL protocol | - | [Document/MaterialMcpProtocol.md](Document/MaterialMcpProtocol.md) |
  113. | Animation protocol | - | [Document/AnimationMcpProtocol.md](Document/AnimationMcpProtocol.md) |
  114. | Google OAuth setup | - | [Document/Google_OAuth_Setup.md](Document/Google_OAuth_Setup.md) |
  115. ## What Agents Can Do
  116. | Area | Examples |
  117. | --- | --- |
  118. | UMG widgets | Create widgets, set slot data, reorder tree nodes, replace subtrees, export and apply JSON |
  119. | Blueprint / BlueCode | Create graphs, add nodes, connect pins, bind widget references, apply compact code-like statements |
  120. | Materials | Build UI materials, set scalar/vector parameters, add HLSL snippets, validate supported material fields |
  121. | Animation / Sequencer | Create UMG animation tracks and keyframes for render transform, opacity, color, and timing |
  122. | Editor utilities | Inspect selected assets, read project state, manage the active target, and run focused tests |
  123. Example prompt for an MCP-capable agent:
  124. ```text
  125. Create /Game/UI/WBP_LoginPanel with a centered login card, email and password fields,
  126. a primary submit button, and a subtle material background. Export the final widget JSON
  127. and summarize which MCP tools changed the asset.
  128. ```
  129. ## Videos
  130. - [Designing an RTS UI](https://youtu.be/O86VCzxyF5o)
  131. - [Recreating the UE5 editor](https://youtu.be/h_J70I0m4Ls)
  132. - [Editing UMG inside the UMG editor](https://youtu.be/pq12x2MH1L4)
  133. - [Chatting with Gemini to edit a UMG file](https://youtu.be/93_Fiil9nd8)
  134. ## Troubleshooting
  135. | Symptom | Fix |
  136. | --- | --- |
  137. | MCP client reports `ConnectionRefusedError`, `WinError 10061`, or `WinError 1225` | Open Unreal Editor first, enable `UmgMcp`, then call `list_umg_mcp_servers`. Each editor uses a unique OS-assigned port; reconnect to the endpoint in its live discovery record. |
  138. | `uv` is not recognized | Install `uv`, restart the terminal, or use the optional local virtual environment setup above. |
  139. | Plugin does not compile after copying between projects | Confirm the project is using UE 5.8 Win64, remove stale generated build output for this plugin/project, then let Unreal rebuild. |
  140. | Tool calls succeed but edit the wrong widget | Set the active UMG target first or pass the full asset path, for example `/Game/UI/WBP_LoginPanel.WBP_LoginPanel`. |
  141. | A protocol command is unclear | Use the web manual for workflow guidance and the protocol markdown files for exact payload shapes. |
  142. ## Fab And Open Source
  143. | Edition | Best for | Notes |
  144. | --- | --- | --- |
  145. | Open source repository | Protocol review, research, custom integration, issue fixes | Core UMG MCP behavior remains available here. |
  146. | Fab edition | Artists, technical artists, and production projects that want a packaged install | Adds the marketplace install path, in-editor workflow packaging, and production-focused support. |
  147. Core protocol improvements are intended to flow back to the open repository. If you report an issue from a project using the Fab package, include your UE version, plugin version, target asset path, and the failing MCP tool payload when possible.
  148. ## Developer Program
  149. Developers who contribute useful fixes, tests, documentation, or protocol examples can request Fab access for validation work. Open an issue or contact the maintainer with the contribution link and the scenario you want to test.
  150. ## License
  151. This repository is released under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.