Skip to content

UEMCP 0.1.1 — defect fixes from a real project

Pre-release
Pre-release

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 29 Oct 08:44
· 19 commits to main since this release

Superseded by v0.1.2 — v0.1.2 makes ue_blueprint read 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.capture no longer hangs until the 45 s server timeout: the bridge bounds the capture itself, returns CAPTURE_TIMEOUT with 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.query no longer returns an "empty success": when parent class, variables and graphs are all empty it raises UNSUPPORTED with per-property diagnostics. Root cause: UE Python does not expose parent_class / new_variables on 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_params returns value: null only 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.
  • delete confirmation is enforced by the MCP server only; a direct bridge client is never asked to confirm.