1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | unreal-mcp(收录于 EpicGames/unreal-engine-skills-for-claude-code-plugin) |
| 作者/维护者 | Epic Games |
| 来源链接 | https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin/tree/main/skills/unreal-mcp |
| 许可证 | MIT(GitHub API 获取) |
| GitHub Stars / Forks | 整个仓库 169 / 18(GitHub API 获取;该数字统计的是仓库内 3 个技能的合集,不代表 unreal-mcp 单个技能自身的热度) |
| 最新版本 | 无独立版本号,仓库持续滚动更新,最近一次提交 2026-07-22(GitHub API 获取) |
| 安装方式 | Claude Code 官方插件市场一键安装:/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official |
2. 功能介绍与亮点
unreal-mcp 让 Claude Code 通过 MCP(Model Context Protocol)实时连接并操控正在运行的 Unreal Editor。Editor 一侧运行 Epic 官方的 ModelContextProtocol 与 AllToolsets 插件,通过引擎自身的 ToolsetRegistry 暴露 30 余个工具集、数百个操作,覆盖 Actor/场景、蓝图、资产、材质与网格、Sequencer 与 Control Rig 动画、Niagara 特效、UMG 界面与 Gameplay Ability System、C++ 自动化测试等。
亮点:① 官方出品——工具集直接注册在引擎自身的 ToolsetRegistry 上,非第三方逆向封装;② 只暴露 list_toolsets/describe_toolset/call_tool 三个元工具、按需发现具体工具,控制上下文体积;③ 文档附一套完整“安全规则”(先保存再操作、等待编译完成、串行调用、检查返回状态、注意 PIE 模式);④ 已收录进 Anthropic 官方的 Claude Code 插件市场,一条命令即可安装。
3. 适用场景
所属分类:集成与工作流自动化(核心动作是通过 MCP 协议连接并操作 Unreal Editor 这一外部系统,本质是“驱动另一个软件”)。
典型场景:正在用 Unreal Engine 做游戏、需要在编辑器里创建或修改 Actor、蓝图、材质、关卡序列、Niagara 特效、UMG 界面的开发者,可用自然语言让 Claude Code 完成这些编辑器操作;也适合批量生成关卡内容、跑自动化测试、Live Coding 后自动重编译的团队场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方发布于 Anthropic 的 claude-plugins-official 插件市场,.claude-plugin 清单与 SessionStart hook 均为 Claude Code 专用打包格式 |
| Codex | ⚠️ 需要适配 | SKILL.md 指令文本与背后的 MCP 协议本身与厂商无关,但当前打包(插件清单、hooks.json)绑定 Claude Code;需手动放置 SKILL.md 并自行配置 MCP 连接 |
| OpenClaw | ⚠️ 需要适配 | 同上,未见官方对 OpenClaw 的适配说明 |
| Hermes Agent | ❓ 未验证 | 材料中未提及,且不作额外搜索验证 |
5. 推荐理由
这是少见的、由引擎厂商官方维护、专为 AI coding agent 设计的编辑器控制技能,而非社区逆向封装:工具集直接注册在引擎自身的 ToolsetRegistry 上,覆盖面(30+ 工具集)与安全文档的成熟度都比第三方方案更高。对用 Unreal 开发的 Claude Code 用户,它能把“打开编辑器手动点”变成一句自然语言指令,官方插件市场一键安装也降低了上手门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Epic Games 是全球两大主流游戏引擎厂商之一,本技能由其官方维护,同时被 Anthropic 官方插件市场收录,构成双重官方背书;但仓库创建仅 2 个月(169 stars/18 forks,该数字属整个 3 技能合集),尚无海量独立第三方讨论积累 |
| 可用性 | 8 | Claude Code 一条 /plugin install 命令即可安装,README 附完整的安装校验步骤、设置参考文档(setup.md)与故障排查矩阵(operations.md);但需要 Unreal Editor 本身启用 ModelContextProtocol 与 AllToolsets 两个插件并手动启动 MCP 服务,并非零配置 |
| 安全性 | 8 | 逐项:①有代码执行——MCP 工具可直接改动编辑器实时状态,execute_tool_script 可在编辑器进程内跑任意 Python,官方文档明确将其定性为“特权操作”并给出使用边界;②服务默认只绑定 localhost,官方明确警告不要暴露到回环接口之外、不要在共享/不受信任机器上运行;③无需存储任何 API Key 或第三方凭据(纯本机编辑器连接);④SKILL.md 内容为正常技术说明,未发现可疑指令;⑤Epic Games 官方出品,无造假迹象;⑥License 为 MIT,明确;⑦近两周仍有提交,维护活跃 |
综合评分:8.0(三项均值)
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 unreal-mcp 的差异 |
|---|---|---|
| Unity-Technologies/skills(unity-cli 等) | Unity 官方出品的 CLI/包管理/项目脚手架技能合集 | 侧重命令行式的项目创建、构建、包管理,覆盖面更偏“工程流程”;unreal-mcp 则是活体编辑器内容操作(Actor/蓝图/材质/序列),两者面向的引擎与操作层级不同,互不替代 |
| gamedev-skills/awesome-gamedev-agent-skills | 社区维护的跨引擎(Godot/Unity/Unreal 等)66 个技能合集,附“主路由器” | 覆盖引擎更广但为第三方社区维护,非官方在引擎内注册的工具集;unreal-mcp 对 Unreal 本身的操作深度(30+ 工具集直连 ToolsetRegistry)更深 |
| Ivan-Murzak 的 Unity-MCP(第三方) | 社区维护的 Unity MCP 服务器 | Unity 官方论坛用户反馈其在 UI 相关创建上不够可靠、工具覆盖不完整;unreal-mcp 作为引擎厂商自己维护的方案,工具集与引擎版本同步更新,工程成熟度上更有优势 |
| nowsprinting/unity-coding-skills | 社区维护的 Unity 测试先行开发流程技能 | 聚焦编码规范与测试驱动开发流程,不涉及实时编辑器操作;与 unreal-mcp 的“驱动编辑器状态”定位互补而非竞争 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;claudepluginhub.com、Claude Directory 等第三方 Claude Code 插件目录已将其收录并提供安装引导页面,但页面本身为自动生成的目录列表,未包含真实使用者的评论内容。
9. 其他补充
仓库附带一个 SessionStart hook,会话开始时注入提示帮助 Claude 识别 Unreal 工程并优先使用本技能;仓库内另有 create-toolset(扩展工具集)与 unreal-skill(编写项目级 Agent Skill)两个配套技能,服务于扩展该 MCP 工具集本身的开发者。
10. 安装使用方式
- 在 Unreal Editor 中启用 ModelContextProtocol 与 AllToolsets 插件
- 运行控制台命令
ModelContextProtocol.StartServer(或启用bAutoStartServer自动启动),默认监听localhost:8000/mcp - 在 Claude Code 中执行:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official
团队协作可将 "unreal-engine-skills-for-claude-code@claude-plugins-official": true 写入项目 .claude/settings.json 的 enabledPlugins,成员信任该项目后会被提示自动安装。
- 安装后运行
/mcp确认unreal-mcp已连接,即可用自然语言操作 Unreal Editor
11. 注意事项
- localhost 并非信任边界:同一台机器上以同一用户身份运行的任意进程都可能连接到该 MCP 服务,官方建议不要在共享/不受信任机器上运行,不要把端口暴露到回环接口之外
execute_tool_script权限很大:可在编辑器进程内执行任意 Python,能改动、移动甚至删除工程内容,官方建议将每次调用当作特权操作对待,并提醒搭配--dangerously-skip-permissions使用会移除逐工具确认门槛、风险显著提升- MCP 操作直接修改实时
UObject状态,官方建议长时间会话前先保存并提交(或 shelve)工作副本 - Windows 下 SessionStart hook 依赖 Git Bash 或 WSL,原生 PowerShell 无法运行该 hook(不影响 MCP 工具本身可用)