Skip to content

UEMCP 0.1.0 — Unreal Engine 5.4 & 5.7

Pre-release
Pre-release

Choose a tag to compare

@KyuuKyuuStone KyuuKyuuStone released this 28 Oct 13:59
· 37 commits to main since this release

中文

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.