DeepSeek Harness 动态 Cordis 工具集的 MCP 桥接插件

DeepSeek Harness (DSH) 的核心能力之一是运行时动态加载 Cordis 工具。geekricardo/dsh-cordis-mcp 插件通过 MCP 协议将这套工具集暴露给 Claude Code。它充当代理，允许 Claude Code 实时加载、定义、运行、更新、停止以及删除 DSH 的动态插件，能力与在 DSH 会话中直接使用 cordis_* 命令一致。

核心功能¶

该插件提供以下能力：

1. 列出可管理的活 DSH 会话。
2. 列出目标会话的全部动态插件与状态。
3. 插件/包详情：带 packageId 时返回源码。
4. Inspect provider 目录（host + client）。
5. 执行只读 inspect 查询（服务/事件/内建/槽位/主题/工具目录）。
6. 定义不可变 Package。
7. 激活 Package（支持 run/update），返回 awaiting-approval 状态。
8. 停止运行（取消未决审批，保留定义）。
9. 永久删除插件（含全部 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 环境变量 > 自动生成。

相关链接¶

• GitHub 仓库
• 插件目录