tags: [unreal-engine, mcp, deepseek-harness, dsh, agent-skills] created: 2026-11-14 status: 定稿 author: GLM-5.3(ZCode)
unreal-skills-port
Epic Games 官方 Unreal Engine MCP Skills 的移植包,打包自 ZCode 官方插件 unreal-engine@zcode-plugins-official v0.1.3(上游 commit a6aa73a),供 DeepSeek Harness (dsh) 等 MCP 客户端接入 Unreal Engine 编辑器使用。
这是什么
真正的能力在 Unreal 引擎内置的 MCP 服务器(标准 MCP 协议,streamable-HTTP),本仓库打包的是配套的 Agent Skills 操作指南——教任何 agent 如何发现并安全地调用引擎暴露的数百个工具(30+ 工具集:Actor、Blueprint、材质、Niagara、Sequencer、Control Rig、GAS、Live Coding、自动化测试等)。
工具在引擎侧注册,与客户端无关:ZCode、dsh、Claude Code 或任何 MCP 客户端连上同一个端点,看到的工具完全一致。
目录结构
├── skills/
│ ├── unreal-mcp/ # 核心 skill:工具发现流程 + 安全规则 + 配置/排障参考
│ ├── create-toolset/ # 伴生 skill:如何给引擎编写新工具集
│ ├── unreal-skill/ # 伴生 skill:如何编写项目级 Agent Skill
│ └── upstream.json # 上游仓库与适配记录
├── .mcp.json # ZCode 插件连接配置(dsh 用户可忽略)
├── .zcode-plugin/ # ZCode 插件元信息(dsh 用户可忽略)
├── README_ZCODE.md # 原版 ZCode 插件说明(英文)
└── README_ZCODE_CN.md # 原版 ZCode 插件说明(中文)
DeepSeek Harness 接入指南
第 1 步:UE 侧开启 MCP 服务器(一次性,所有客户端共用)
打开项目的
.uproject,在Plugins数组中加入并启用两个引擎插件:{ "Name": "ModelContextProtocol", "Enabled": true }, { "Name": "AllToolsets", "Enabled": true }编辑
<Project>/Saved/Config/<Platform>Editor/EditorPerProjectUserSettings.ini,让服务器随编辑器自动启动:[/Script/ModelContextProtocolEngine.ModelContextProtocolSettings] bAutoStartServer=True默认端点为
http://127.0.0.1:8000/mcp(端口冲突时可用ServerPortNumber覆盖)。
详细步骤见 skills/unreal-mcp/references/setup.md。
第 2 步:dsh 侧挂载 MCP 客户端
dsh 通过官方 @deepseek-ai/dsh-mcp-client 插件连接外部 MCP 服务器(工具以 mcp__<server>__<tool> 形式注册)。在 cordis.patch.yml 中以 insert 块挂载,或使用社区的 dsh-mcp-manager 插件图形化管理:
- 传输方式:streamable-http
- URL:
http://127.0.0.1:8000/mcp
安全提示:UE 的 MCP 服务器无鉴权,保持 loopback,不要暴露到公网接口。
第 3 步:移植 SKILL.md 指引
把 skills/unreal-mcp/SKILL.md 的内容放入 dsh 的 skills 机制或项目 AGENTS.md。核心要点:
- 工具发现三步:
list_toolsets→describe_toolset→call_tool(工具不进tools/list,靠元工具按需分发,保持上下文精简) - 安全规则:批量改动前后各保存一次;C++/着色器编译进行中不要调用;依赖型调用串行化;每个结果必须读状态;注意 PIE 状态
- 项目可注册自己的 Agent Skills(
AgentSkillToolset.ListSkills),项目约定优先于通用默认
已知差异
references/setup.md第 3 节、references/operations.md部分内容含 ZCode 专属指引(连接管理、插件设置),dsh 用户按本 README 第 2 步替代即可- dsh 处于 developer preview,API 可能有破坏性变更;本组合未经完整实测
来源与许可
- 上游:EpicGames/unreal-engine-skills-for-claude-code-plugin(MIT,© 2026 Epic Games, Inc.)
- 打包来源:ZCode 官方插件市场
unreal-enginev0.1.3(Z.ai 的适配层见skills/upstream.json) - 本仓库按 MIT 再分发,各
skills/*/LICENSE.txt为原始版权声明,再分发时须保留
No comments yet. Be the first to write one.