UE‑MCP – Unreal Engine 模型上下文协议服务器

它是什么 – 一个 Node.js/TypeScript 服务器，通过 C++ 桥接插件让 AI 助手与 Unreal Editor 通信。它暴露了约 2040 个编辑器操作（关卡、蓝图、材质、VFX、PCG 等）作为 JSON‑RPC 调用，因此自然语言命令可以创建、读取或修改 UE 5 项目。

工作原理

• ue-mcp 在您的 UE 项目中安装一个小型 C++ 插件，并启动一个 WebSocket‑JSON‑RPC 服务器。
• AI 客户端发送纯英文（或结构化）命令；服务器通过桥接器将这些命令转换为 UE API 调用。
• 操作也可以在 ue-mcp.yml YAML 流程中组合，实现多步骤、可重复的工作流。
• 基于 npm 的插件系统允许开发者添加新操作或整个类别。

主要特性

• 29 个工具类别，涵盖从关卡布局到动画、Niagara、PCG、GAS、网络以及新的 UE 5.8 原生工具集。
• 内置 19 步演示，完全通过桥接器程序化构建“Neon Shrine”场景。
• 安全防护 – 写入保护、源代码控制检查和流程回滚以保护项目。
• 可扩展 – 发布 npm 插件（ue-mcp-<plugin>）以注入新操作。
• YAML 流程 – 定义可重复的管道，支持重试、回滚和自定义 JS/TS 任务。
• 跨平台 – 支持 Windows、macOS、Linux（UE 5.4‑5.8）。

典型用例

• 让大型语言模型（例如 Claude、Cursor）迭代设计关卡、资产或游戏系统。
• 自动化重复的编辑器任务（批量导入、材质生成、构建管道）。
• 无需手动 UI 操作即可原型化程序化内容生成管道。
• 在游戏开发工作室的工具中提供 AI 驱动的“助手”功能。

快速开始

npx ue-mcp init   # 检测 .uproject，部署桥接器，启用所需的 UE 插件
npx ue-mcp doctor # 排查连接问题

编辑器重启后，发送如下命令：

"在玩家起始点上方 300 单位处放置一个点光源，强度 5000。"
"以 Development 配置构建项目，并报告任何编译错误。"

安装要求

• Unreal Engine 5.4‑5.8（Windows）或 5.6+（Linux/macOS）。
• Node 18+。
• C++ 工具链（Windows 上的 Visual Studio，macOS 上的 Xcode CLI，Linux 上的 gcc/clang）。
• PythonScriptPlugin（随 UE 捆绑）– 由 init 自动启用。

文档与社区

• 完整文档：https://ue-mcp.com/docs（入门、工具参考、流程、插件、故障排除）。
• MIT 许可，欢迎赞助，接受 PR 和问题。

限制 / 注意事项

• 需要编译的 C++ 桥接器；如果编辑器未重启或缺少工具链，首次运行可能失败。
• 写入权限赋予 AI 对项目文件的完全控制 – 安全防护是可选的，但建议启用。
• 仅支持 UE 5；不支持旧版本引擎。

许可证 – MIT（免费用于个人、教育和商业用途）。