Repository navigation
UEMCP 0.1.1 — defect fixes from a real project
Pre-release
Pre-release
Superseded by v0.1.2 — v0.1.2 makes
ue_blueprintread parent class / generated class / blueprint type / named graphs. This release is kept for history; please download v0.1.2.
中文
修复外部项目组(DTXCPP_57_J2,UE 5.7.4)报告的三个问题,并补齐文档。
下载
UEMCPBridge-5.4.zip— Unreal Engine 5.4(实测 5.4.4)UEMCPBridge-5.7.zip— Unreal Engine 5.7(实测 5.7.4)uemcp-server-0.1.0.tgz— MCP Server 离线包(Node ≥ 20,未发布到 npm registry)SHA256SUMS.txt— 三个产物的校验和
修复
viewport.capture不再挂到 45 秒:桥接内部自行截止,失败时返回CAPTURE_TIMEOUT并附渲染环境诊断,同时不再强制切换游戏视图。根因已定性为「编辑器窗口最小化/失焦时 UE 把 tick 降到约 3 fps」——前台实测 132–976 ms 成功,最小化 20.2 s 超时。blueprint.query不再返回「空成功」:父类/变量/图三者全空时改为返回UNSUPPORTED,并给出逐属性探测结果。根因是 UE Python 对 Blueprint 资产不暴露parent_class/new_variables等属性(5.4 与 5.7 一致),真正的结构读取仍需更换 API,尚未解决。- 中文乱码:
/mcp(含 SSE)、/health、错误响应统一带charset=utf-8,PowerShell 5.1 等按 Latin-1 解码的客户端不再乱码。
明确不是缺陷
ue_material_params的value: null只出现在基材质;材质实例(MIC)读取正常且有真实值。这是引擎 API 边界。
已知限制
- 蓝图节点级编辑、PIE 内 Actor 操作、资产导入导出不支持。
- 蓝图结构读取(父类/变量/图)当前不可靠,读不到时返回
UNSUPPORTED。 - 截图需要编辑器窗口在前台且可见。
delete的确认只在经 MCP Server 时强制;直连 bridge 端口不会校验。
English
Fixes three issues reported by an external project (DTXCPP_57_J2, UE 5.7.4) plus documentation updates.
Downloads
UEMCPBridge-5.4.zip— Unreal Engine 5.4 (tested 5.4.4)UEMCPBridge-5.7.zip— Unreal Engine 5.7 (tested 5.7.4)uemcp-server-0.1.0.tgz— offline MCP server bundle (Node ≥ 20; not published to npm)SHA256SUMS.txt— checksums for all three
Fixed
viewport.captureno longer hangs until the 45 s server timeout: the bridge bounds the capture itself, returnsCAPTURE_TIMEOUTwith render-environment diagnostics, and stops forcing the game view. Root cause: UE throttles ticks to ~3 fps while the editor window is minimized or unfocused — foreground captures measured 132–976 ms, minimized 20.2 s timeout.blueprint.queryno longer returns an "empty success": when parent class, variables and graphs are all empty it raisesUNSUPPORTEDwith per-property diagnostics. Root cause: UE Python does not exposeparent_class/new_variableson Blueprint assets (same on 5.4 and 5.7); 真正 reading blueprint structure still needs a different API and is not solved.- Mojibake: JSON/SSE responses now carry
charset=utf-8.
Not a defect
ue_material_paramsreturnsvalue: nullonly for base materials; material instances (MIC) expose real values. This is an engine API boundary.
Known limitations
- No blueprint node editing, PIE actor operations, or asset import/export.
- Blueprint structure introspection is unreliable and now fails explicitly with
UNSUPPORTED. - Capture requires the editor window to be foreground and visible.
deleteconfirmation is enforced by the MCP server only; a direct bridge client is never asked to confirm.