DeepSeek Harness (DSH) 的核心能力之一是運行時動態加載 Cordis 工具。geekricardo/dsh-cordis-mcp 插件通過 MCP 協議將這套工具集暴露給 Claude Code。它充當代理，允許 Claude Code 實時加載、定義、運行、更新、停止以及刪除 DSH 的動態插件，能力與在 DSH 會話中直接使用 cordis_* 命令一致。
核心功能¶
該插件提供以下能力：
- 列出可管理的活 DSH 會話。
- 列出目標會話的全部動態插件與狀態。
- 插件/包詳情：帶
packageId時返回源碼。 - Inspect provider 目錄（host + client）。
- 執行只讀 inspect 查詢（服務/事件/內建/槽位/主題/工具目錄）。
- 定義不可變 Package。
- 激活 Package（支持 run/update），返回
awaiting-approval狀態。 - 停止運行（取消未決審批，保留定義）。
- 永久刪除插件（含全部 Package、授權、版本指針）。
安裝與啓用¶
使用官方安裝腳本：
curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-cordis-mcp/main/install.sh | bash
腳本會自動完成以下步驟：
1. 在 ~/.dsh/profiles/web/package.json 中寫入依賴。
2. 將 dsh-cordis-mcp 追加至 dsh.profile.bundles。
3. 執行 pnpm install。
4. 提示重啓服務。
安裝完成後重啓 DSH 服務（例如使用 pm2）：
pm2 restart dsh-web
接入 Claude Code¶
在 Claude Code 中添加 MCP 服務：
claude mcp add dsh --transport http http://127.0.0.1:8090/mcp
認證配置¶
MCP 端點強制 Bearer 認證，未配置 Token 則返回 503 錯誤。Token 需在 DSH 設置頁（dsh-cordis-mcp 設置）中配置，支持自動生成、自定義和重新生成。
在 Claude Code 的配置文件（如 .mcp.json）中設置請求頭：
{
"mcpServers": {
"dsh": {
"type": "http",
"url": "http://127.0.0.1:8090/mcp",
"headers": { "Authorization": "Bearer <設置頁裏的 token>" }
}
}
}
安全與注意事項¶
該插件具有等同於 Shell 的權限，請勿將端口暴露到非本機環境。
- 強制認證：端點強制 Bearer 認證，無 Token 一律返回 401 或 503。
- Loopback 限制：僅接受 Loopback 訪問（
127.*/localhost/::1），拒絕外部訪問。 - 無 CORS：端點永不返回 CORS 頭，網頁無法直接讀取響應。
- 會話歸屬：動態插件按會話歸屬，是進程內存態，DSH 重啓即清空。
- 審批流程：含 Client half 的包首次運行需走 DSH 審批流，返回
awaiting-approval。 - Token 解析優先級：設置頁配置 >
DSH_MCP_TOKEN環境變量 > 自動生成。
