ChiR24/Unreal_mcp

这是什么？

核心功能

• 01对外只暴露一个 MCP 工具，提供搜索、查看、执行和配置四种操作。
• 02直接运行在 Unreal Editor 内，支持 Streamable HTTP 或 stdio 加 WebSocket 两种连接方式。
• 03覆盖关卡、蓝图、UMG、材质、Niagara、PCG、AI 和关卡序列等模块。
• 04严格校验参数，删除等破坏性操作需要确认授权。
• 05默认仅监听本机地址，并要求能力令牌。

适用场景

• 在聊天中让 AI 助手生成 Actor、放置灯光并搭建关卡。
• 批量生成蓝图事件图或 UMG 控件布局。
• 由助手驱动 Play-In-Editor 并截图，检查编辑器内的成果。
• 团队内多个 MCP 客户端共享同一个运行中的编辑器。

快速上手

1. 1

   从发布页面下载 v0.6 预发布版的插件压缩包

2. 2

   将 EngineWire 文件夹复制到项目的 Plugins 目录中

   MyGame/Plugins/EngineWire/
3. 3

   在项目设置中启用 Enable Native MCP Server，然后重启编辑器

4. 4

   使用能力令牌将服务器添加到 Claude Code

   claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"

使用前须知

• !需要 Unreal Engine 5.0 至 5.8，且项目包含 C++ 代码；纯蓝图项目需使用预编译二进制文件。
• !预编译二进制文件仅适用于其构建时所针对的引擎小版本和平台。
• !README 描述的是 0.6 测试版，之前的稳定版 0.5.30 工具结构不同。

标签

常见问题

Unreal_mcp 是什么？

基于 MCP 协议的 Unreal Editor 插件，让 AI 助手直接在运行中的编辑器里搭建关卡、蓝图与材质。 EngineWire 让 Claude、Cursor、VS Code 等支持 MCP 的 AI 客户端连接到正在运行的 Unreal Editor。核心是一个原生 C++ 编辑器插件，在编辑器游戏线程上执行操作；另有基于 TypeScript 的 stdio 服务端，适合只能启动本地命令的客户端。两种方式都只暴露一个名为 unreal 的 MCP 工具，通过 search、describe、execute、configure 四种操作调用近 400 项能力。

Unreal_mcp 可以免费使用吗？用的什么许可证？

Unreal_mcp 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Unreal_mcp 还在维护吗？

活跃维护中。Unreal_mcp 最近一次提交是在 2026年10月19日。

Unreal_mcp 适合用来做什么？

在聊天中让 AI 助手生成 Actor、放置灯光并搭建关卡。 批量生成蓝图事件图或 UMG 控件布局。 由助手驱动 Play-In-Editor 并截图，检查编辑器内的成果。 团队内多个 MCP 客户端共享同一个运行中的编辑器。

Unreal_mcp 怎么安装和运行？

从发布页面下载 v0.6 预发布版的插件压缩包 将 EngineWire 文件夹复制到项目的 Plugins 目录中: MyGame/Plugins/EngineWire/ 在项目设置中启用 Enable Native MCP Server，然后重启编辑器 使用能力令牌将服务器添加到 Claude Code: claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"

在哪里获取 Unreal_mcp？

源代码和安装说明在 GitHub 上：https://github.com/ChiR24/Unreal_mcp