Unreal MCP 服务器 Unreal MCP Server — 370+ AI Tools for UE5 Editor Automation via MCP

将Claude Code、Cursor、Windsurf、Claude Desktop、VS Code（Copilot）、Antigravity、OpenCode或任何兼容MCP的AI代理直接连接到虚幻引擎5.7编辑器。

v4版本共搭载了54个类别的378个编辑器工具，以及15个上下文资源和14个工作流提示，通过JSON-RPC 2.0通过可流式HTTP实现——让你的AI助手成为真正的共同开发者，涵盖关卡构建、游戏脚本、过场动画、视觉特效、音频、网络、动画、UI、源码管理、自动测试、运行时调试、建模、材质图层、混沌破坏和元人类。

🎬 视频展示 https://www.youtube.com/watch?v=wEuaFqUPp00

🚀 v4（对比v3）v4的新意是代理原生版本——围绕AI代理的实际工作方式重新构建。工作流程相同，上下文更便宜，多步骤编辑更安全。

目录模式（默认）—— ~95% 减少代理上下文

• tools/list 返回 4 个发现元工具 + ~30 个核心工具（~3K token），而不是全部 378 个模式（~60K token）。代理人通过search_tools、list_tool_categories和get_tool_schemas按需发现剩余的。所有电话都保持可呼叫。将 ToolExposureMode = Full 设置为旧行为。

run_tool_script — 将多步程序作为一个交易

• 带有结果引用（save_as / “$var.field”）和foreach循环的顺序工具调用，在一次编辑事务中执行（全有或全无，第一次失败时回滚）。一个24个角色级别的块化变成了单次调用和一次Ctrl+Z键——从而消除批处理中的N往返问题。

后台任务——长距离操作不再被阻挡

• 长期运行的工具（光照/导航构建、断裂、重网格、PCG执行、fal.ai 生成、自动化运行）在3秒宽限窗口后返回{task_id， status： “working”}。投票以get_task_status进展，中止cancel_task，列举于list_tasks。以工具形式实现，因此每个MCP客户端都能在无能力协商的情况下工作。

闭环图编辑——代理自行验证自己的编辑

• describe_graph 在一次调用中返回完整的蓝图拓扑（节点 + 引脚 + 去重边列表 + 编译状态），替换了 N 次往返×get_node_pins次。还有get_execution_paths、move_node、delete_nodes、评论、重定向、find_orphaned_nodes、list_node_types和list_actor_components/get_component_info。

建模和混沌现在已经真实存在（v3 中的模式存根）

• 建模（5）：多重拉伸、多重切割、布尔、uv_unwrap、重新网格——通过GeometryScript实现，包含前后三角形计数。
• 混沌：chaos_create_geometry_collection和chaos_fracture（沃罗诺伊/集群/均匀/位面）现在真正执行;chaos_apply_force应用运行时脉冲。

结构化输出无处不在

• 每个返回 JSON 的工具都会附带结构化内容和人类可读的文本。结构化错误带有机器可读的{code， hint， did_you_mean[]}——代理启用恢复流程代码，而非正则表示，大幅减少重试循环。

全能撤销

• 每个变异工具现在都运行在自己的名为 MCP：<tool> editor 事务中。Ctrl+Z按键正常操作;多步脚本会合并成一个撤销步骤。

硬化核心

• 请求体大小限制（解析前的HTTP 413）、工具调用超时（结构化超时错误）、异常保护（抛出工具返回结构化内部错误，避免编辑器崩溃）、空闲会话垃圾回收、真实的BindAddress设置，以及通过Host头验证实现DNS重新绑定防御。

质量由注册库范围的测试矩阵保护

• MatrixSpec 生成整个注册表的契约测试。新工具一出现即即被覆盖;开发过程中发现了v3编辑器崩溃和5个无声bug。export_tool_docs会从实时注册表重新生成每个工具的引用，这样文档就不会漂移。

重新设计的状态栏

🚀 主要特征

• 378个编辑工具，涵盖54个类别——演员、材质、材质图层/图表、蓝图、序列器、景观、植被、尼亚加拉、音频、MetaSound、MetaSound图表、物理、混沌、导航、PCG、GAS、增强输入、网络、AI行为树、AnimGraph、StateTree、控制绑定、CommonUI、AI 3D/图像生成、源代码控制、测试创作、运行时调试、PIE、建模、MetaHuman，以及v4元/任务发现层。
• 目录模式——渐进式工具披露降低了新会话的工具定义成本 ~95%（~3K 对 ~60K token），同时保持所有 378 个工具可调用。
• 工具预设 — 完整/场景构建/游戏玩法/极简/目录。立即切换以管理AI上下文成本。
• 多步工具脚本——run_tool_script将一个序列（带变量和循环）作为一个全有或全无的编辑事务运行。
• 完全撤销支持——每个变异操作都是其自身命名的编辑器事务;脚本可以合并成一个撤销步骤。
• 通用AI兼容——Claude Code、Claude Desktop、Cursor、VS Code（Copilot）、Windsurf、Antigravity、OpenCode以及任何兼容MCP的客户端。可流式HTTP + SSE — 无厂商锁定。
• 15 上下文资源——项目数据、层级层级、选定参与者、性能统计、能力检测、撤销历史等。
• 60个蓝图工具——组件、变量、线节点、集合属性、完整图回读、执行路径追踪和清理。
• 源代码控制感知——对任何Unreal支持的供应商（Perforce、Git LFS、Plastic、Subversion）有效。
• 生产级安全——持有令牌认证、源允许列表、范围门控、结构化错误、协作取消、试运行、请求大小限制、工具调用超时、异常保护、会话GC、DNS重新绑定防御。

📦 包含内容

• 带可扩展架构的完整 C++ 源代码
• 涵盖54个类别的378种工具
• 5个工具预设（完整/场景构建/游戏玩法/极简/目录）
• 15个只读上下文资源
• 14个可重复使用的工作流程提示
• AI驱动的图像生成与通过fal ai实现的文本/图像转三维
• 非HTTP客户端的STDIO桥接器（Claude桌面版）
• 实时状态栏指示器，一键复制 Claude 代码配置
• 持有人令牌授权、源允许列表、范围门控、速率限制
• 注册库生成的工具参考（export_tool_docs）及全面文档

🧩 工具类别（54种）核心 — 演员（16）、编辑器（7）、资产（6）、关卡（6）、资产管理（7）、批处理（3） 场景构建 — 材质（5）、材质图（8）、材质图层（4）、静态网格（7）、环境（4）、建模（5） 脚本 — 蓝图（60）、Python 桥（1）、搜索（2） 电影 — 序列器（12）、动画（5）、动画图（14）、控制绑定（2） 世界构建 — 景观（3）、植被（4）、样条（7）、世界划分（2）、空间（10）、PCG（9） 视觉特效与音频 — 尼亚加拉（3）、音频（3）、MetaSound（6） MetaSound Graph（8） 仿真 — 物理（9）、导航（3）、混沌（5） 角色 — MetaHuman （4） 数据 — 数据工具（6） UI — 小部件/UMG（15）、CommonUI（4）、UI Image （2） 游戏玩法 — GAS（8）、增强输入（6）、游戏框架（6）、游戏标签（3）、状态树（5）、PIE（9） 网络 — 网络（5） AI — AI 工具（8）、3D 模型（3） DevOps — 源代码控制（8）、测试创作（5）、运行时调试（7） 工作流 — 宏（6）、构建（7）、Engine API（3）、性能（4） 代理（v4） — 元与任务（8）

🔌 插件依赖（自动启用） EditorScriptingUtilities、Niagara、PCG、EnhancedInput、SourceControl、FunctionalTesting、GeometryScripting、Fracture、GameplayAbilities（可选）、PythonScriptPlugin（可选）

⚙️ 技术参数

• 协议：MCP 规范 2025-06-18，可流式 HTTP
• 传输方式：JSON-RPC 2.0 通过 HTTP（默认端口 13579）+ SSE 备份
• 引擎支持：虚幻引擎5.7（Windows，macOS，Linux）
• 线程处理：所有 UE API 调用自动分配到游戏线程
• 源代码：包含完整 C++ 访问权限
• 认证：持有令牌 + 起源允许列表（默认仅限本地主机）
• 文档：https://www.strayspark.studio/docs/unreal-mcp-server