# UMG MCP

网页教程 · UE 5.8

README English

当前包信息

Unreal Engine 5.8 · Win64 · 每个编辑器使用独立的系统分配本机端口。

AI 辅助 UMG 工作流

## 通过明确的 MCP 工具创建 Unreal UMG 界面。

UMG MCP 让 Agent 读取真实 Widget Tree，修改布局和 Slot，应用 Blueprint 逻辑，编辑材质，创建 UMG 动画，并把 UI 资产作为结构化 JSON 做导出与回写。

按顺序安装 Fab 商店 GitHub

### 推荐路径

1. 1 安装 Fab 包，或把源码克隆到 `Plugins/UmgMcp`。
2. 2 在 Unreal Engine 5.8 中启用插件并重启编辑器。
3. 3 配置模型供应商，或连接外部 MCP 客户端。
4. 4 先跑联通测试，再让 Agent 创建一个小型 UMG 资产。

## 安装

### Fab 版

适合需要市场安装包和编辑器内工作流的项目。

1. 从 Fab 为 Unreal Engine 5.8 安装 UMG MCP。
2. 打开项目，启用 `UmgMcp`，然后重启编辑器。
3. 在插件设置中选择 Google OAuth、Gemini API、智谱 AI、OpenAI 兼容端点或本地模式。
4. 使用编辑器内对话面板，或连接外部 MCP 客户端。

### 源码版

适合协议开发、Issue 修复或手动集成。

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

然后用 UE 5.8 打开项目，让 Unreal Build Tool 编译插件。

## 连接 MCP 客户端

先打开 Unreal Editor。每个编辑器会发布独立的系统分配端点，Python MCP server 会发现并连接所选编辑器桥接。

    {
      "mcpServers": {
        "UmgMcp": {
          "command": "uv",
          "args": [
            "run",
            "--directory",
            "D:\\UE5Project\\YourProject\\Plugins\\UmgMcp\\Resources\\Python",
            "UmgMcpServer.py"
          ]
        }
      }
    }

必须使用绝对路径。
目录必须是 `Resources/Python`。
Windows 路径要转义。
JSON 中写成 `D:\\Path`。
先验证再做大任务。
优先运行 `APITest` 下的测试脚本。

## 教程

### 模型配置

配置本地模型、Google OAuth、API Key、智谱 AI 和 OpenAI 兼容供应商。

### 对话工作流

了解编辑器内 chat、develop、learning、task 四种模式。

### MCP 支持

查看 Widget、Blueprint、Material、Animation 和 Editor 工具族。

## 协议参考

Widget MCP 协议 Blueprint / BlueCode 协议 Material MCP 协议 Animation MCP 协议 Google OAuth 配置 FabServer 串联流程

## 排错

现象 | 处理方式
--- | ---
`ConnectionRefusedError` 或 `WinError 10061` | 打开 Unreal Editor，启用插件，重启编辑器，然后重新连接 MCP 客户端。
系统找不到 `uv` | 安装 `uv`，或在 `Resources/Python` 下创建本地虚拟环境。
Agent 改错了 Widget | 先设置当前 UMG 目标，或传入完整资产路径，例如 `/Game/UI/WBP_Login.WBP_Login`。