【免费下载链接】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点击查看免费下载如果你以为 MCP 服务器只有工具调用这一种玩法那 Unreal_mcp 会刷新你的认知。Unreal_mcp 是一个功能完整的 Model Context ProtocolMCP服务器用 TypeScript C 构建让 AI 助手通过原生 C Automation Bridge 插件直接控制 Unreal Engine 编辑器。除核心的unreal工具外它还在 stdio 和原生/mcp两条链路上完整实现了 MCP 的三大原语Resources资源、Prompts提示、Completions补全以及长任务的进度通知机制。本文带你一次读懂这些原语在 Unreal_mcp 中是怎么落地、怎么用起来的。为什么 Tools 还不够MCP 原语全景MCP 协议里tools/call只是让 AI 动手干活的通道。但真实的开发工作流还需要三样东西资源Resources让 AI看到编辑器当前状态——项目信息、健康度、当前选中的 Actor提示Prompts给 AI 一份操作剧本按步骤引导它完成检查工作流补全Completions帮 AI 精确敲定参数比如 400 多个 capability 的 id 到底叫什么进度通知Progress渲染、光照构建这种慢操作让客户端实时看到百分比而不是干等。Unreal_mcp 在initialize握手时向客户端宣告的能力面恰好就是这四样{ tools: {}, resources: {}, prompts: {}, completions: {} }这个能力声明定义在 primitive-wiring.ts原生链路的对应实现在plugins/EngineWire/Source/EngineWire/Private/MCP/下。值得注意的是它没有声明 resource 订阅subscriptions也没有 task API——能力面精确到声明什么就提供什么不多不少。资源Resources给 AI 装上一双眼睛资源是只读的。Unreal_mcp 通过ue://前缀的 URI 暴露编辑器状态注册逻辑在 resource-handlers.ts。可用资源一览URI内容原生/mcp支持ue://capability/catalog带单调修订号的 capability 目录✅ue://project脱敏的项目名、引擎版本、内容根✅ue://state/revisions选区、关卡、资产包修订计数器✅ue://health服务器健康与性能指标✅ue://automation-bridge桥接诊断与最近活动✅ue://assets/ue://actors/ue://editor/ue://selection资产列表、关卡 Actor、编辑器状态、选中项❌返回RESOURCE_UNAVAILABLE最后四个实时状态 URI 只在游戏线程上才能安全读取stdio 链路会经 Automation Bridge 往返取数而原生链路在 socket 线程应答不能阻塞编辑器工作所以干脆不服务它们。三种资源模板按 id 取数除静态 URI 外还有三个模板定义在 resource-catalog.ts客户端可以按变量取值ue://capability/{capabilityId}—— 单个 capability 的有界记录标识、类别、动作数不含完整 schemaue://knowledge/{topic}—— 按主题组织的稳定 Unreal 引擎知识ue://asset/{assetPath}—— 某内容路径下资产的规范化句柄。修订号Revision状态会不会过期所有资源读取都带 64 KiB 上限、路径归一化与脱敏见 mcp-primitives.md。每个载荷还携带一个revision只有ue://capability/catalog的修订号会变动跟随configure的可见性变化其余 URI 恒定上报初始修订号1。实现见 resource-revision.ts。 对新手很实用读完ue://project确认引擎版本再读ue://health看桥接是否正常最后读ue://capability/catalog掌握目录——三步就能让 AI 对现场建立完整认知全程零副作用。Prompts六份内置操作剧本prompts/list和prompts/get提供六个固定工作流提示prompts.ts原生侧为McpPromptCatalogPrompt场景关键参数inspect-fix检查并修正一个对象属性objectPath必填asset-import导入资产到项目destinationPath必填level-build创建关卡、构建光照、保存levelPath必填blueprint-edit读取蓝图、加变量与组件、编译blueprintPath必填validation只读验证项目/资产/关卡assetPath可选sequence-render准备并执行 Movie Render Queue 任务sequencePath必填以sequence-render为例它会渲染出五步剧本读取序列属性 → 创建 MRQ 任务 → 配置输出 → 排队 → 启动渲染每一步都标注了对应的describe/execute调用和一条安全提示渲染是长任务且会写文件由你显式启动。三条值得记住的设计原则只返回文本消息——获取一个 prompt 永远不会执行任何操作执行决定权始终在 AI和人类手里严格参数校验——未知参数、缺失必填项、超过 512 字符的值都会被InvalidParams拒绝自带免责声明——每个提示的末尾都写着以上任何内容都不会替你执行每一步请自己跑并复核回执。Completions参数补全的四档评分与三重保险面对 400 多个 capabilityAI 拼错一个 id 就会全盘卡壳。completion/complete就为此而生实现见 completions.ts。它只覆盖三个封闭词表ue://capability/{capabilityId}的capabilityId含别名与旧式tool.action名仅限已启用的工具ue://knowledge/{topic}的topicue://asset/{assetPath}的assetPath内容根路径以及工作流 prompt 中枚举型参数的取值如sourceFormat的fbx/obj/gltf/png/wav。匹配按四档评分排序前缀 子串 子序列 允许一个拼写错误typo 匹配只在没有更好结果时才出场。三重保险让输出永远有界且安全保险规则数量与体积最多 100 条、合计不超过 8 KiB前缀上限前缀超过 128 字符直接返回空路径安全主机绝对路径、目录穿越前缀一律拒绝所有候选池都在内存中补全过程不扫描编辑器、也不碰宿主机文件系统。进度通知给渲染和光照构建装上进度条渲染视频、构建光照动辄几分钟。MCP 的做法是客户端在tools/call里带上_meta.progressToken服务器就会为该请求推送notifications/progress通知数据源正是 Unreal 自身的进度事件。Unreal_mcp 的这套实现progress-reporter.ts、progress-sink-registry.ts有几处教科书级的细节token 只读、绝不代写progress-token.ts 原样读取客户端的 token字符串42和数字42严格区分。没发 token那就没有进度——服务器宁可沉默也不会自己编一个 id 顶替否则客户端根本关联不上单调递增progress严格只增Unreal 重复上报或倒退的数值会被过滤客户端的进度条永不倒转有界防洪每个操作最多 64 条通知状态文本截断到 512 字符病态的话痨源头无法刷爆 JSON-RPC 通道串行投递通知按内部 Promise 链排队保证客户端收到的顺序和上报顺序一致不会出现先看到 80% 再看到 50%精准路由ProgressSinkRegistry 用规范化 MCP 请求 id 做键把每个请求的进度和它的 token严格隔离并发请求互不串线表容量上限 256超限按最旧优先淘汰收尾干净结果返回前或请求取消时流即刻关闭晚到的帧永远不会拖在最终结果后面。总结四原语如何协同成一个完整闭环把四个原语串起来就是 Unreal_mcp 推荐的看 → 定 → 做 → 盯工作流看Resources读ue://project/ue://health/ue://capability/catalog建立现场认知定Completions Prompts用补全敲定 capability id或取一份 prompt 拿到分步剧本做Tools通过唯一的unreal工具execute一个 capability拿到数据与回执盯Progress长操作携带_meta.progressToken实时接收有界、单调、按序的notifications/progress。全部实现集中在 src/server/mcp-primitives/ 目录原生 C 侧在plugins/EngineWire/Source/EngineWire/Private/MCP/Primitives/与Private/MCP/Resources/两条链路的协议行为详见 protocol.md。理解了这一层超越 Tools的原语你才算真正用完了 Unreal_mcp 给 AI 助手准备的全部能力。赞分享【免费下载链接】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点击查看免费下载相关推荐Everything MCP Server 功能全景解析Tools、Prompts、Resources、订阅通知与 Tasks 的源码级导读Everything MCP Server 功能全景解析Tools、Prompts、Resources、订阅通知与 Tasks 的源码级导读 本文围绕 Eve示例工程MCP 服务人工智能工具调用MCP 协议核心原语实战指南Resources、Prompts、Tools、Sampling、Roots 与 Transports 全解析结合 browser-tools-mcp 仓库源码MCP 协议核心原语实战指南Resources、Prompts、Tools、Sampling、Roots 与 Transports 全解析结合 browseAI 应用MCP 服务浏览器控制开发工具前端MCP Python SDK 服务端原语全解析Tools、Resources、Prompts 与配套能力实战指南MCP Python SDK 服务端原语全解析Tools、Resources、Prompts 与配套能力实战指南 一个 MCPServer 实例向已连接的客户人工智能MCP 服务MCP Clients工具调用上一篇在 Kubernetes 中部署 Unbound 缓存 DNS 解析器helm/charts 仓库 stable/unbound Chart 完整实战指南下一篇Kill-doc浏览器内文档下载的优雅解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考