前言¶
DeepSeek Harness (DSH) 的核心设计理念是插件化。Unreal Engine 5.8 引入了官方的 ModelContextProtocol 服务器。dsh-unreal-mcp 是一个适配器插件，旨在将 DSH 的 UE 适配能力带到与 Epic Claude Code 集成相当的实际边界。它不包含 UE 引擎代码或通用的 MCP 客户端实现，而是专注于打包、配置和上下文管理。
核心功能¶
该插件通过 DSH 的生命周期管理 Cordis 插件，并提供以下能力：
- Cordis 插件管理：由 DSH 的加载/卸载生命周期管理。
- 内置 Unreal Skills：
unreal-mcp：发现并调用现有的 Unreal Editor Toolsets。create-toolset：编写 AI 可调用的 C++ 或 Python Toolsets。unreal-skill：在编辑器内编写注册UAgentSkill类或项目特定 Skill 资产的指南。
- 上下文路由：基于会话的
.uproject和 UE 源树检测，并通过ctx.systemPrompt.context()路由简洁的 Unreal 上下文。 - 只读诊断：检查连接、工具搜索和 ToolsetRegistry。
安装¶
使用前需满足以下环境要求：
- Unreal Engine 5.8（需启用
ModelContextProtocol和AllToolsets） - DeepSeek Harness 兼容版本 0.1.1-rc.2
- Node.js 20 或更新版本，且
dsh plugin可访问pnpm - 一个用于测试的 disposable Unreal 项目
安装命令如下：
dsh plugin --profile web add /absolute/path/to/dsh-unreal-mcp
如果使用打包后的 tarball：
npm pack
dsh plugin --profile web add /absolute/path/to/dsh-unreal-mcp-0.1.0.tgz
典型用法¶
安装后，需启动 Unreal MCP 服务器和 DSH 客户端，并使用诊断命令验证连接。
- 启动 Unreal MCP 服务器：在 Unreal Editor 控制台中执行：
ModelContextProtocol.StartServer 8000
- 启动 DeepSeek Harness：
dsh --profile web
- 诊断连接：在项目根目录执行诊断脚本：
npm run diagnose -- --endpoint=http://127.0.0.1:8000/mcp --cwd="/absolute/path/to/MyGame/Content"
注意事项与安全¶
- 权限要求：Unreal MCP 拥有编辑器级别权限。执行变更任务时，必须使用已测试恢复点的临时项目，并保留匹配的工具结果和最终编辑器状态作为证据。
- 安全策略：插件中的 Skill 指导代理顺序发出 UE 调用，在执行变更前要求明确用户授权，并在重试非幂等操作前检查 UE 状态。具体的执行调度、重试和沙箱机制仍由 DSH 负责。
- 许可证：项目代码为 MIT 许可证。改编的 Epic Skill 材料保留 Epic 的 MIT 通知。
插件目录：dsh-unreal-mcp
源代码仓库：GitHub
