DeepSeek Harness (DSH) 采用插件化架构。在管理 MCP(Model Context Protocol)服务器时,通常需要直接编辑配置文件。dsh-mcp-hub 插件在 DSH 内置了 MCP 服务器管理面板,在会话视图环提供「MCP」标签页,用于集中查看和配置当前 profile 的所有 MCP 服务器。
功能说明¶
该插件提供以下能力:
- 配置读取与展示:读取并展示
cordis.patch.yml(profile 层)以及各 bundle 层的 MCP 配置。 - 实时工具注册表:从当前进程的工具注册表中反查出每个已连接的 MCP 服务器,展示暴露的工具数量,并标注“已配置但当前进程未连接”的服务器。
- 可视化配置:每台服务器一张卡片,支持编辑
serverName、transport、url(或command+args)、env、toolCallTimeoutMs。支持新增、删除、保存操作。 - 保存即生效:保存时会重写
cordis.patch.yml。新增的 MCP 服务器通常支持热连接,已有项的修改需要重启 DSH 应用。 - 本机安全:RPC 路由仅接受
127.0.0.1/localhost请求,并经过 endpoint 白名单校验。
安装与启用¶
在 web profile 的 package.json 的 dependencies 中添加插件引用:
"dependencies": { "dsh-mcp-hub": "file:E:/dsh/dsh-mcp-hub" }
同时,在 dsh.profile.bundles 中添加插件名称:
"dsh.profile.bundles": ["dsh-mcp-hub"]
完成上述修改后,重启 DSH Web。
使用方法¶
- 打开会话,在会话视图环中找到「MCP」标签页。
- 面板展示三块内容:
- 当前进程已连接的 MCP:点击 ▸ 展开查看该服务器暴露的工具。
- MCP 配置:可编辑的服务器卡片,保存后写回 profile。
- 来自 bundle(只读):各插件 bundle 里自带的最小化 MCP 补丁。 - 常用操作:
- 新增:点击「+ 添加服务器」填写配置,保存。
- 修改:直接编辑卡片内容,保存。
- 删除:点击卡片内的「删除」,保存。
配置字段¶
| 字段 | 说明 | 示例 |
|---|---|---|
| serverName | 服务器标识(字母/数字/点/下划线/中划线) | stock |
| transport | 传输方式 | streamable-http / sse / stdio |
| url | 非 stdio 时的服务地址 | http://192.168.1.108:8038/mcp |
| command | stdio 时的启动命令 | npx |
| args | stdio 参数(空格分隔) | -y @modelcontextprotocol/server-foo |
| env | 环境变量(每行 KEY=VALUE) |
KEY=xxx |
| toolCallTimeoutMs | 单次工具调用超时(毫秒) | 300000 |
注意事项¶
- 插件本身零运行时依赖,React 由宿主提供。
- RPC 路由仅接受本机请求,有白名单校验。
- 新增的 MCP 通常立即热连接,已有项的修改需重启 DSH。
- 保存时重写
cordis.patch.yml。