Skip to content

Releases

UEMCP v0.1.5

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 03 Nov 08:58

中文

本版集中修复业务团队《UEMCP v0.1.4 复测缺陷单》确认的四条缺陷(D1–D4),不需要使用者改任何自己的代码:换上新插件包 + 新 server 包、重启编辑器即可。D5(screen-space UWidget 截图)经复核为引擎合成层边界,窗口截屏模式排入 0.1.6。

下载(Downloads)

  • 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.5.tgz — MCP Server 离线包(Node ≥ 20,未发布到 npm registry)
  • SHA256SUMS.txt — 三个产物的 SHA-256 校验和(大小以 SHA256SUMS.txt 旁文件为准)

修复(Fixed,逐条对应缺陷单编号)

  • D1:ue_viewport_capture 的 activateWindow 参数现在由 MCP 层原样透传到 Bridge(v0.1.4 的 Server schema 不认这个参数,会报 INVALID_ARGUMENT: Unrecognized key,只有直连 Bridge 18778/rpc 才能用)。开启后置前并校验前台,成功返回带 activation{requested, ok, editorPid, foregroundPid, hwnd, isIconic, alreadyForeground};失败仍立即 EDITOR_UNSAFE_STATE(reason=window_not_foreground,details 带 editorPid/foregroundPid/hwnd/isIconic/hint),不干等超时。注意 activateWindow 默认 false(不传则不置前、不校验)。
  • D2:ue_log_query 的级别判定兼容 UE 的隐式 LogXxx: 行:显式 : Error: / : Warning: / : Display: / : Verbose: 段优先;否则 Log+首字母大写类别名(如 LogMarker:)视为 Log;都不匹配则 level=null 且不计入 levels 过滤,返回带 unclassified 计数。v0.1.4 中 levels:["Log"] 会静默漏掉全部隐式 LogXxx: 行("matched 0" 误判为没发生)。
  • D3:ue_reflect 的 target 支持裸类名短名解析(如 CustomDomainCmdHandler,含工程模块类):走派生类搜索 / 世界内实例搜索,不再必须写全路径(v0.1.4 只吃 /Script/… 全路径,裸类名直接 NOT_FOUND);解析失败时错误 details 返回 candidates 候选全路径,照抄即可。
  • D4:ue_call_function 新增 captureLog:true(调用窗口日志旁路):调用期间在窗口内捕获日志,返回 logLines[{lineNo, level, text}]——void 函数不再只能拿到 {"returned":null,"returnedVoid":true},业务结果(如 handler 打的 JSON 日志行)可直接随调用读回。

已知限制(Known limitations)

  • 窗口截屏模式(method:"window")尚未提供,已排入 0.1.6:ue_viewport_capture 目前只能截引擎渲染的视口画面。
  • UE 侧 screen-space UWidgetComponent 不进 hires 截图(缺陷单 D5 复核结论):这类 widget 属 Slate 合成层,由 UI pass 叠加在 scene renderer 输出之后,take_high_res_screenshot 拿不到——这是引擎渲染管线行为,不是插件缺陷。需要带标记的画面时,请先用外部窗口截屏(Win32 PrintWindow/桌面截图)对照验收,窗口截屏模式 0.1.6 提供。
  • object.call 的函数名黑名单按子串拦截 python / exec / eval / subprocess:名字里含这些子串的正常业务函数会被误拦(安全优先于便利)。函数命名请避开这些词;被拦时的错误信息会写明命中了黑名单。

升级提示(Upgrade notes)

  • 从 v0.1.4 升级:整目录覆盖插件 + npm install -g uemcp-server-0.1.5.tgz,重启编辑器;用 /health 的 pluginVersion=0.1.5、buildHash 变化、sourcePath 指向当前工程 Plugins/UEMCPBridge 三项确认升级生效。
  • 备份旧版时把 .uplugin 一并改名(如 UEMCPBridge.uplugin.bak)或移出 Plugins/,否则备份会顶掉新版(second location will be ignored)。
  • 验收 activateWindow 前先确认 server 包确为 0.1.5:调用带 "activateWindow": true 若报 Unrecognized key,说明包未含 D1 修复,请回传完整错误 JSON。

English

This release fixes the four defects (D1–D4) confirmed in the business team's v0.1.4 defect report. No changes are required on your side: swap in the new plugin and server packages and restart the editor. D5 (screen-space UWidget capture) was re-verified as an engine compositing boundary; a window-capture mode is scheduled for 0.1.6.

Downloads

  • UEMCPBridge-5.4.zip — Unreal Engine 5.4 plugin (tested 5.4.4)
  • UEMCPBridge-5.7.zip — Unreal Engine 5.7 plugin (tested 5.7.4)
  • uemcp-server-0.1.5.tgz — offline MCP server bundle (Node ≥ 20; not published to npm)
  • SHA256SUMS.txt — SHA-256 checksums for all three (file sizes are whatever the sums file accompanies)

Fixed (per defect-report IDs)

  • D1: ue_viewport_capture now passes activateWindow through the MCP layer to the bridge (the 0.1.4 server schema rejected the key with INVALID_ARGUMENT: Unrecognized key, so it only worked when calling the bridge port 18778/rpc directly). When enabled, the window is restored and the foreground state verified; success returns activation{requested, ok, editorPid, foregroundPid, hwnd, isIconic, alreadyForeground}, failure returns immediately with EDITOR_UNSAFE_STATE (reason=window_not_foreground, details carry editorPid/foregroundPid/hwnd/isIconic/hint). Note activateWindow defaults to false (no activation/verification unless requested).
  • D2: ue_log_query level inference now recognises UE's implicit LogXxx: lines: explicit : Error: / : Warning: / : Display: / : Verbose: segments win; otherwise Log + a capitalised category (e.g. LogMarker:) counts as Log; anything else keeps level=null, is excluded from levels filtering, and is reported via an unclassified count. In 0.1.4, levels:["Log"] silently missed every implicit LogXxx: line ("matched 0" was read as "never happened").
  • D3: ue_reflect target accepts bare class names (e.g. CustomDomainCmdHandler, including project-module classes) via derived-class search / in-world instance search — a full /Script/… path is no longer required (0.1.4 returned NOT_FOUND for bare names); on failure the error details carry candidates with the resolved full paths.
  • D4: ue_call_function accepts captureLog:true (in-call log bypass): log lines captured inside the call window are returned as logLines[{lineNo, level, text}] — a void function no longer leaves the caller with only {"returned":null,"returnedVoid":true}; business results logged by your handler come back with the call itself.

Known limitations

  • The window-capture mode (method:"window") is not provided yet — scheduled for 0.1.6; ue_viewport_capture currently captures only the engine-rendered viewport.
  • Screen-space UWidgetComponent on the UE side does not appear in hires screenshots (D5 re-verification): such widgets live in the Slate compositing layer, applied after the scene renderer output, so take_high_res_screenshot cannot include them — an engine rendering-pipeline behaviour, not a plugin defect. For frames that must show the markers, use an external window screenshot (Win32 PrintWindow/desktop capture) until the 0.1.6 window-capture mode ships.
  • object.call name blacklist matches by substring on python / exec / eval / subprocess: legitimate business functions whose names contain these substrings are blocked (safety over convenience). Avoid these substrings when naming functions; the error message names the matched blacklist term.

Upgrade notes

  • From v0.1.4: overwrite the plugin directory and npm install -g uemcp-server-0.1.5.tgz, restart the editor; confirm via /health — pluginVersion=0.1.5, a changed buildHash, and sourcePath pointing at the project's Plugins/UEMCPBridge.
  • When backing up the old version, rename its .uplugin (e.g. UEMCPBridge.uplugin.bak) or move it out of Plugins/, otherwise the backup shadows the new build (second location will be ignored).
  • Before acceptance-testing activateWindow, make sure the server package is really 0.1.5: if a call with "activateWindow": true fails with Unrecognized key, the package predates the D1 fix — please send back the full error JSON.

UEMCP 0.1.4 — generic primitives, PIE control, auditable builds

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 30 Oct 10:30

中文

这一版把业务两天试用里「必须写 Python 胶水代码」的最后几类场景也变成了一等公民工具:新增三条通用原语 ue_reflect / ue_call_function / ue_log_query——不需要使用者改自己的任何框架或代码,装上新包、重启编辑器即可在 MCP 客户端里直接调用。

下载(Downloads)

  • UEMCPBridge-5.4.zip — Unreal Engine 5.4 插件包(实测 5.4.4),158,583 B
  • UEMCPBridge-5.7.zip — Unreal Engine 5.7 插件包(实测 5.7.4),158,583 B
  • uemcp-server-0.1.4.tgz — MCP Server 离线包(Node ≥ 20,未发布到 npm registry),707,343 B
  • SHA256SUMS.txt — 三个产物的 SHA-256 校验和

新增(Added)

  • 三条通用原语(不需要使用者改自己的代码/框架):
    • ue_reflect(object.reflect):反射任意 UObject 的可调用函数清单(只读恒可见)。
    • ue_call_function(object.call):调用对象函数——之前只能 ue_python_exec 硬凑的事现在是一等公民调用(写类原语:read-only 策略下不注册,与 ue_actor_edit 同门;使用需 standard/full 策略)。
    • ue_log_query(log.query):按正则/级别/时间过滤编辑器日志,返回命中行与行号;只读恒可见;Bridge 侧用 realpath 把可读范围严格限制在当前工程的 Saved/Logs/ 目录内。
  • ue_pie_control(v0.1.3 引入,本版随包分发):start / stop / restart / status,可 simulate。不需要 --allow-exec 就能点 Play——写动作只走 allowWrite 门,只读策略下收窄为 status。
  • ue_policy_explain(v0.1.3 引入,本版随包分发):列出每个工具在当前策略下「可见/不可见」及原因(server.policy / server.allowConsole / server.allowExec)。
  • 截图增强(v0.1.3 引入,本版随包分发):activateWindow 置前并校验;返回绝对路径 + sha256 + mtime + bytes + stats{uniqueColors, nonZeroRatio, isBlack};超时后文件若在 500 ms 宽限内落盘,返回 ok:true, partial:true。
  • /health 可追溯字段(v0.1.3 引入,本版随包分发):buildHash(插件 Python 全量 sha256)、buildTime、sourcePath(实际加载的插件目录)、instanceId。升级后核对 buildHash 与 sourcePath,可发现「备份目录顶替新版」的加载错误(详见 README「常见使用坑」第 2 条)。

修复(Fixed)

  • 会话池加固(v0.1.3 引入,本版随包分发):满仓按 LRU 逐出最老会话(优先裸 POST 会话,不动正在推流的 SSE 会话);429 带 retryAfterMs;initialize 响应带过期预告头 Mcp-Session-Expires-In-Ms;404 -32001 带 hint: reinitialize,客户端重新 initialize 即自愈。
  • activateWindow 快速失败:恢复窗口后若仍最小化或未置前,立即返回 EDITOR_UNSAFE_STATE(window_not_foreground),不再干等到超时。

升级提示(Upgrade notes)

  • 不需要使用者改任何代码:换上新插件包 + 新 server 包,重启编辑器即可。
  • 升级备份请把 .uplugin 一并改名(如 UEMCPBridge.uplugin.bak)或移出 Plugins/,否则旧备份可能顶掉新版(second location will be ignored)。
  • 用 ue_call_function 前确认策略不是 read-only(可用 ue_policy_explain 自查)。

已知限制(Known limitations)

  • 蓝图变量列表、每图节点数读不到(引擎 protected 属性,需 C++ 模块);父类/生成类/类型/已命名图可读。
  • 基材质默认参数值读不到(引擎 API 边界);材质实例(MIC)正常。
  • 蓝图节点级编辑、PIE 内 Actor 写操作、资产导入导出不支持。
  • 截图需要编辑器窗口可渲染;activateWindow=true 时若窗口恢复后仍最小化/未置前会快速失败(EDITOR_UNSAFE_STATE)而不是干等。
  • delete 的确认只在经 MCP Server 调用时强制;不要把 bridge 端口直接暴露给自定义客户端。
  • ue_log_query 只能读当前工程日志目录(<projectDir>/Saved/Logs/,realpath 约束)。

English

This release turns the last "write-your-own-Python-glue" scenarios from the two-day business trial into first-class tools: three universal primitives — ue_reflect, ue_call_function and ue_log_query — require no changes to your own framework or code. Install the new packages, restart the editor, and call them straight from your MCP client.

Downloads

  • UEMCPBridge-5.4.zip — Unreal Engine 5.4 plugin (tested 5.4.4), 158,583 B
  • UEMCPBridge-5.7.zip — Unreal Engine 5.7 plugin (tested 5.7.4), 158,583 B
  • uemcp-server-0.1.4.tgz — offline MCP server bundle (Node ≥ 20; not published to npm), 707,343 B
  • SHA256SUMS.txt — SHA-256 checksums for all three

Added

  • Three universal primitives (no changes needed on your side):
    • ue_reflect (object.reflect): list callable functions of any UObject (read-only, always visible).
    • ue_call_function (object.call): call an object function — what previously required ue_python_exec workarounds is now a first-class call (write-class primitive: not registered under read-only, same gate as ue_actor_edit; requires standard/full policy).
    • ue_log_query (log.query): filter the editor log by regex/level/timestamp and get matching lines with line numbers; read-only, always visible; the bridge restricts reads to the current project's Saved/Logs/ directory via realpath.
  • ue_pie_control (introduced in v0.1.3, shipped in this package): start / stop / restart / status, optional simulate. Play-In-Editor no longer requires --allow-exec — write actions are gated by allowWrite only, and read-only policy narrows the action to status.
  • ue_policy_explain (introduced in v0.1.3, shipped in this package): per-tool visibility with the reason (server.policy / server.allowConsole / server.allowExec).
  • Capture improvements (introduced in v0.1.3, shipped in this package): activateWindow (restore + verify foreground), absolute path plus sha256 / mtime / bytes / stats{uniqueColors, nonZeroRatio, isBlack}; if the file lands within a 500 ms grace after a timeout, the call returns ok:true, partial:true.
  • /health build metadata (introduced in v0.1.3, shipped in this package): buildHash (sha256 over all plugin Python files), buildTime, sourcePath (the plugin directory actually loaded), instanceId. After upgrading, compare buildHash and sourcePath to catch a backup directory shadowing the new build (see README "Common pitfalls" #2).

Fixed

  • Session pool hardening (introduced in v0.1.3, shipped in this package): LRU eviction of the oldest session when full (bare-POST sessions first, active SSE streams kept); retryAfterMs on 429; session-expiry hint header Mcp-Session-Expires-In-Ms on initialize; hint: reinitialize on 404 -32001 — clients re-initialize and recover on their own.
  • activateWindow fails fast: after restoring, if the window is still minimized or not foreground, it returns EDITOR_UNSAFE_STATE(window_not_foreground) immediately instead of waiting for the timeout.

Upgrade notes

  • No changes are needed on your side: swap in the new plugin + server packages and restart the editor.
  • When backing up an old version, rename its .uplugin (e.g. UEMCPBridge.uplugin.bak) or move it out of Plugins/, otherwise the backup can shadow the new build (second location will be ignored).
  • Before using ue_call_function, make sure the policy is not read-only (self-check with ue_policy_explain).

Known limitations

  • Blueprint variable lists and per-graph node counts are unreadable (protected engine properties; requires a C++ module). Parent class / generated class / type / named graphs are readable.
  • Base-material default parameter values are unreadable (engine API boundary); material instances work.
  • No blueprint node editing, PIE actor write operations, or asset import/export.
  • Capture requires a renderable editor window; with activateWindow=true, a window that is still minimized or not foreground after restoration fails fast (EDITOR_UNSAFE_STATE) instead of waiting.
  • delete confirmation is enforced by the MCP server only; do not expose the bridge port to custom clients.
  • ue_log_query can only read the current project's log directory (<projectDir>/Saved/Logs/, realpath-constrained).

UEMCP 0.1.2 — blueprint structure reads

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 29 Oct 08:56

中文

在 v0.1.1 基础上补齐蓝图结构读取能力。

下载

  • 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 — 三个产物的校验和

修复(相对 v0.1.1)

  • ue_blueprint query 现在能读到真实结构:parentClass、generatedClass、blueprintType 改从 Asset Registry 标签读取(UE 5.4.4 实测得到 Actor / Blueprint_CeilingLight_C / BPTYPE_Normal);EventGraph、UserConstructionScript、AnimGraph 通过 BlueprintEditorLibrary.find_graph 按名发现。
  • variables 仍然读不到:UBlueprint.NewVariables 是引擎的 protected 属性,Python 无法读取。现在返回 variablesUnavailable=NEW_VARIABLES_PROTECTED_IN_ENGINE_PYTHON,不再返回一个看起来「没有变量」的空数组。
  • 保留 v0.1.1 的其余修复:截图内部硬截止 + 诊断、charset=utf-8。

已知限制(不变)

  • 蓝图节点级编辑、PIE 内 Actor 操作、资产导入导出不支持。
  • 蓝图变量列表不可读;图节点数不可读(EdGraph.Nodes 亦为 protected),只能确认图存在。
  • 截图需要编辑器窗口在前台且可见。
  • delete 的确认只在经 MCP Server 时强制。

English

Adds real blueprint structure reading on top of v0.1.1.

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

Fixed (since v0.1.1)

  • ue_blueprint query now returns real structure: parentClass, generatedClass and blueprintType are read from Asset Registry tags (verified on 5.4.4: Actor, Blueprint_CeilingLight_C, BPTYPE_Normal); EventGraph / UserConstructionScript / AnimGraph are discovered via BlueprintEditorLibrary.find_graph.
  • variables remain unavailable: UBlueprint.NewVariables is a protected engine property. The response now reports variablesUnavailable=NEW_VARIABLES_PROTECTED_IN_ENGINE_PYTHON instead of an empty list.
  • All v0.1.1 fixes are included (bounded capture timeout with diagnostics, charset=utf-8).

Known limitations (unchanged)

  • No blueprint node editing, PIE actor operations, or asset import/export.
  • Blueprint variables and per-graph node counts are unreadable (protected in engine Python); graph presence is available.
  • Capture requires the editor window to be foreground and visible.
  • delete confirmation is enforced by the MCP server only.

UEMCP 0.1.1 — defect fixes from a real project

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 29 Oct 08:44

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.

UEMCP 0.1.0 — Unreal Engine 5.4 & 5.7

Pre-release

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 28 Oct 13:59

中文

UEMCP 编辑器桥接插件的首个公开版本。

下载

  • UEMCPBridge-5.4.zip — Unreal Engine 5.4(实测 5.4.4)
  • UEMCPBridge-5.7.zip — Unreal Engine 5.7(实测 5.7.4)
  • SHA256SUMS.txt — 下载后请先校验

安装

  1. 解压到 <YourProject>/Plugins/,确保得到 <YourProject>/Plugins/UEMCPBridge/UEMCPBridge.uplugin。
  2. 在项目里启用 UEMCPBridge、PythonScriptPlugin、EditorScriptingUtilities 三个插件。
  3. 启动编辑器。桥接监听 127.0.0.1:18778(被占用时回退 18779–18788),发现文件写入 ~/.uemcp/。
  4. 验证:curl http://127.0.0.1:18778/health 应返回 app=uemcp-bridge。

MCP Server 侧(Node.js)在仓库的 uemcp/ 目录,见 uemcp/README-DEV.md。

本次内容

  • 纯 Python 编辑器插件,无 C++ 编译步骤,Modules: []。
  • 桥接端全局限流(令牌桶 30 req/s),叠加在服务端每会话限流之上。
  • UE 5.7 兼容性核查(见包内 COMPAT-UE57.md)。
  • 11 个无需编辑器的自检脚本。

已知限制

  • 不支持蓝图节点/图编辑、PIE 内 Actor 操作、资产导入导出。
  • isPartitioned 恒为 false(UWorld::IsPartitionedWorld 未暴露给 Python)。
  • ue_python_exec 与 ue_console_command 需两端同时显式开启。

English

First public release of the UEMCP editor bridge plugin.

Downloads

  • UEMCPBridge-5.4.zip - Unreal Engine 5.4
  • UEMCPBridge-5.7.zip - Unreal Engine 5.7
  • SHA256SUMS.txt - verify downloads before use

Install

  1. Unzip into <YourProject>/Plugins/ so you get <YourProject>/Plugins/UEMCPBridge/UEMCPBridge.uplugin.
  2. Enable UEMCPBridge, PythonScriptPlugin and EditorScriptingUtilities in the project's .uplugin/Plugins settings.
  3. Start the editor. The bridge listens on 127.0.0.1:18778 (falls back to 18779-18788) and writes its discovery file to ~/.uemcp/.
  4. Verify: curl http://127.0.0.1:18778/health -> app=uemcp-bridge.

The MCP server side (Node.js) lives in uemcp/ in the repository - see uemcp/README-DEV.md.

What is in this release

  • Pure Python editor plugin, no C++ build step, Modules: [].
  • Global bridge rate limit (30 req/s, token bucket) on top of the server-side per-session limit.
  • UE 5.7 compatibility audit (see COMPAT-UE57.md inside the package).
  • 10 self-test scripts runnable without the editor.

Known limits

  • Blueprint node/graph editing, PIE actor operations and asset import/export are not supported.
  • isPartitioned is always reported as false (UWorld::IsPartitionedWorld is not exposed to Python).
  • ue_python_exec and ue_console_command are disabled unless explicitly enabled on both sides.

服务端(新增附件)/ Server side (new asset)

MCP Server 现已提供离线安装包 uemcp-server-0.1.0.tgz(已实测离线安装与 stdio 握手,默认 read-only 返回 7 个工具):

npm install -g ./uemcp-server-0.1.0.tgz
uemcp --transport http --policy read-only

未发布到 npm registry(npm view @uemcp/server 返回 404 属预期);需要 Node ≥ 20。

The MCP server is now available as an offline tarball uemcp-server-0.1.0.tgz (offline install and stdio handshake verified; read-only policy exposes 7 tools). It is not published to the npm registry; npm view @uemcp/server returning 404 is expected. Node ≥ 20 required.