从0.5.x迁移到0.6：Unreal_mcp单一unreal工具革命完全指南与直接调用移除处理-北京尧图网络

【免费下载链接】Unreal_mcpA comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine through the native C Automation Bridge plugin. Built with TypeScript and C.项目地址https://gitcode.com/gh_mirrors/un/Unreal_mcp点击查看免费下载如果你正在使用 Unreal_mcp 让 AI 助手操控 Unreal Engine那么从 0.5.x 升级到 0.6 是一次真正的「单一 unreal 工具革命」0.5.30 对外暴露的 23 个独立 MCP 工具在 0.6 中被永久合并为唯一的unreal网关工具任何仍按旧方式直接调用工具名的请求都会收到一张可执行的DIRECT_TOOL_CALL_REMOVED迁移回执。本文用最短路径带你完成迁移并逐条讲清这次变更背后的动机、回执机制与破坏性改动。⚠️版本提示0.6 目前发布在 npm 的beta标签下unreal-engine-mcp-serverbetalatest仍指向 0.5.30。升级前建议先通读 CHANGELOG.md 中各 beta 版本的⚠️ Migration小节。从 23 个工具到 1 个工具这次「革命」改了什么0.5.30 时代客户端在tools/list里能看到 23 个独立工具manage_asset、control_actor、manage_blueprint……每个工具又挂载几十个 action。对 AI 客户端来说这意味着数百份工具 schema 同时挤在上下文里——既昂贵又容易诱发「幻觉式」的错配调用。0.6 把整个公共面收敛为一个静态的unreal工具版本客户端可见的工具能力规模0.5.3023 个独立工具1,379 个{tool, action}命名0.6beta-f 统计1 个unreal工具416 条能力记录、1,554 个可调用{tool, action}对三个必须知道的结论这是永久切换没有开关。TypeScript 侧的MCP_GATEWAY_MODE环境变量与原生侧的Enable Native GatewaybEnableNativeGateway项目设置均已被删除不存在「恢复旧 23 工具列表」的选项。两条链路行为一致。无论走原生 HTTPRoute A默认端口3000还是 stdioRoute Btools/list永远只返回unreal并抑制tools/list_changed通知。23 个父工具降级为内部路由边界。它们不再出现在客户端列表中但execute仍接受{tool, action}旧式拼写——旧调用里的工具名和 action 名基本都还能用只是入口从「直接调工具」变成了「调unreal」。单一 unreal 工具的 4 个操作search → describe → execute0.6 的整个公开面就是unreal工具的 4 个操作模型按需只加载即将使用的那一份契约而不是几百份 schema操作作用search用 2–4 个自然词如spawn actor、save level搜索能力每行附带可直接发送的nextCalldescribe返回某能力的精确契约参数、schema、示例以及若需要consent 授权execute用经过校验的参数执行一个能力返回数据与「改动清单」回执configure启用/停用内部工具组从不触碰编辑器典型的一次「召唤点光源」对话从 0.5 的「猜工具名猜参数」变成三步{ operation: search, query: spawn actor }{ operation: describe, tool: control_actor, action: spawn }{ operation: execute, tool: control_actor, action: spawn, params: { classPath: /Script/Engine.PointLight, actorName: KeyLight, location: [0, 0, 300] } }完整契约说明见 docs/gateway-client-guide.md全部能力的生成式参考清单在 docs/action-reference.generated.md。直接调用移除DIRECT_TOOL_CALL_REMOVED 回执如何工作这是 0.6 唯一的「硬破坏」任何tools/call的name不是unreal比如name: manage_asset的请求不再被路由而是返回一张有界、可复制粘贴执行的迁移回执{ success: false, operation: execute, errorCode: DIRECT_TOOL_CALL_REMOVED, tool: control_actor, message: Direct tool calls are removed. Call the unreal gateway with operation execute to run control_actor.spawn., nextCall: { operation: execute, tool: control_actor, action: spawn, params: { classPath: /Script/Engine.PointLight } } }回执里的nextCall只下钻一层规则非常克制你的旧调用回执给出的nextCall工具名不认识如拼错{ operation: search }并附suggestions最多 3 个最近似候选工具名认识、但没给 action{ operation: describe, tool: tool }工具名和 action 都有{ operation: execute, tool, action, params: {…} }—— 直接重放你的原始请求其中params的迁移规则把旧调用里嵌套的params包装摊平顶层键优先再剔除action、subAction、params、operation四个控制字段只留下真正的业务参数。把这张nextCall原样通过unreal跑一遍迁移即完成——这也是官方为模型准备的「自愈」通道。实现代码可对照阅读TypeScript 侧在 direct-call-migration.ts原生传输侧的等价实现在 McpNativeGatewayDirectCallMigration.cpp两条链路保证同一形状的回执。迁移三步走从 0.5.x 旧调用到 0.6 新调用换服务器客户端配置改用npx -y unreal-engine-mcp-serverbeta启动务必保留beta否则装到 0.5.30与 0.6 插件不匹配传入UE_PROJECT_PATH并确保 Node.js ≥ 20.190.6 不再支持 Node 18。换插件删除Plugins/McpAutomationBridge解压EngineWire-plugin-version.zip到其位置0.6 中插件已更名为EngineWire.uproject里若写的是旧名McpAutomationBridge请改为EngineWire——旧名下的设置项[/Script/McpAutomationBridge.McpAutomationBridgeSettings]在 0.6 中仍能被加载无需手工搬移。改调用点把tools/call中name: manage_asset之类的旧调用改成对unreal的调用先search找到能力再describe拿契约最后execute执行。不确定具体该调哪个时直接重发回执里的nextCall即可。0.6 破坏性变更检查清单除了直接调用移除以下变更同样会影响 0.5.x 时代的客户端与脚本变更影响应对MCP_GATEWAY_MODE与Enable Native Gateway移除无法回退到 23 工具列表接受单一unreal入口按上文迁移插件更名 McpAutomationBridge → EngineWire旧插件目录、旧.uproject引用失效换目录、改引用旧设置自动加载Node.js 下限升至 20.19Node 18 环境无法运行 stdio 服务升级 Nodemanage_post_process并入manage_render直接调用manage_post_process报does not match prefix改调manage_render并传subActioncontrol_actorspawn 的meshPath无法解析时直接失败0.5 时代「仍会生成一个坏 actor 并返回成功」的行为消失视为修复现在返回MESH_NOT_FOUND场景不被污染npmlatest仍是 0.5.30npm install默认拿不到 0.6固定使用beta标签验证迁移是否成功插件加载后编辑器状态栏应显示MCP :3000 (0)客户端连上后括号里的数字 1。让助手执行「列出当前关卡的 actor」「在视图口截图」这类请求——它应能通过一次search找到能力并返回真实结果而不再是DIRECT_TOOL_CALL_REMOVED。若某次调用仍返回该回执检查两点客户端是否仍在直接以旧工具名发起tools/call运行的服务器是否为beta版本。服务端开发可跑npm run test:unit与npm run registry:check验证契约与生成物一致能力记录目录 src/tools/catalog/capabilities/records/ 是唯一事实来源所有*.generated.*文件都由此生成切勿手改。参考资料与关键文件 README.md —— 0.6 线总览、快速开始与unreal工具说明 docs/gateway-client-guide.md —— 网关契约「Deprecation and removal behavior」一节专讲DIRECT_TOOL_CALL_REMOVED docs/action-reference.generated.md —— 全部能力、副作用、scope 与 consent 的生成式清单 docs/security-and-receipts.md —— 授权拒绝码、consent 与回执安全 docs/protocol.md —— 两条传输链路、协议版本协商与取消机制 CHANGELOG.md —— 0.6.0-beta-a 起每个 beta 的 Migration 小节️ plugins/EngineWire/ —— 引擎侧 C 插件源码⚙️ scripts/generate-canonical-registry.ts —— 能力记录到生成契约、原生分片与 action reference 的生成流水线迁移的本质可以一句话概括入口从「23 个工具名」收敛为「1 个unreal工具」而旧名字并没有死——它们作为内部路由边界和可解析别名继续工作回执会替你走完剩下的路。赞分享【免费下载链接】Unreal_mcpA comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine through the native C Automation Bridge plugin. Built with TypeScript and C.项目地址https://gitcode.com/gh_mirrors/un/Unreal_mcp点击查看免费下载相关推荐RedisShake革命性Redis数据迁移与处理工具完全指南RedisShake革命性Redis数据迁移与处理工具完全指南还在为Redis数据迁移而头疼吗面对复杂的云环境、版本兼容性问题、数据过滤需求传统迁移方案数据库后端运维PyTorch Image Models版本升级从0.6.x到1.0迁移指南PyTorch Image Models版本升级从0.6.x到1.0迁移指南 PyTorch Image Modelstimm 作为深度学习领域最受人工智能计算机视觉深度学习Element3部署与发布完全教程从开发到上线的完整流程Element3部署与发布完全教程从开发到上线的完整流程 Element3作为基于Vue3的组件库提供了丰富的UI组件解决方案。本教程将带您完成从环境搭建到上一篇如何在Windows电脑上实现AirPlay 2投屏终极免费解决方案下一篇APKMirror终极指南如何安全高效地下载和管理安卓应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

从0.5.x迁移到0.6：Unreal_mcp单一unreal工具革命完全指南与直接调用移除处理

相关推荐

PCL2启动器微软账户登录皮肤显示问题终极解决方案指南

读写FM11RF005M标签Vb6源码

语雀如何导出别人的知识库！超实用教程！支持导出markdown/html/word/pdf等超多格式！一键解析，批量下载！保留大纲的层级结构！一键克隆！原格式

更多资讯

SecureCRT 9.5 中文版安装避坑指南：Win10/11 兼容性与静默失败修复

AI竞赛实战指南：七大赛题从图像缺陷检测到大模型Agent解析

PHPCMS V9 UTF8源码包实战：安装、模板与二次开发避坑指南

从录音到剪辑：选秀物料工程化交付全流程解析

自制WPS AI插件：接入大模型API实现文档摘要与翻译

GitHub Copilot 入门：在 VS Code 里解释代码和补全函数

今日更新

Verilog实现FPGA密码锁：矩阵键盘与状态机设计实战

数据服务监控运维实战：从指标体系到告警治理与故障排查

FreeRTOS任务通知实战详解：内核原理、API与避坑指南

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？