Repository navigation
UEMCP 0.1.0 — Unreal Engine 5.4 & 5.7
Pre-release
Pre-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— 下载后请先校验
安装
- 解压到
<YourProject>/Plugins/,确保得到<YourProject>/Plugins/UEMCPBridge/UEMCPBridge.uplugin。 - 在项目里启用
UEMCPBridge、PythonScriptPlugin、EditorScriptingUtilities三个插件。 - 启动编辑器。桥接监听
127.0.0.1:18778(被占用时回退 18779–18788),发现文件写入~/.uemcp/。 - 验证:
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.4UEMCPBridge-5.7.zip- Unreal Engine 5.7SHA256SUMS.txt- verify downloads before use
Install
- Unzip into
<YourProject>/Plugins/so you get<YourProject>/Plugins/UEMCPBridge/UEMCPBridge.uplugin. - Enable
UEMCPBridge,PythonScriptPluginandEditorScriptingUtilitiesin the project's.uplugin/Plugins settings. - Start the editor. The bridge listens on
127.0.0.1:18778(falls back to 18779-18788) and writes its discovery file to~/.uemcp/. - 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.mdinside 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.
isPartitionedis always reported as false (UWorld::IsPartitionedWorldis not exposed to Python).ue_python_execandue_console_commandare 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.