前言¶
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
