DeepSeek Harness (DSH) 采用“一切皆插件”的架构。在管理 MCP 服务器实例时，传统的配置方式通常需要手动编辑配置文件或依赖 patch 配置，操作不够直观。dsh-mcp-manager 是一个针对 DSH 的 MCP 管理插件，它通过 Web GUI 提供了启停 mcp-client 实例的能力，并支持从本机配置文件中自动发现并导入 MCP 服务器。
该插件由 welsione 维护，开源协议为 MIT。
核心功能¶
-
Web GUI 设置面板
在 DSH 的设置页会出现“MCP 管理”入口。该面板列出了所有已挂载的mcp-client实例，支持通过搜索和筛选（全部/已启用/已停用）快速定位，并支持一键开关。 -
真启停
与简单的开关不同，该插件提供的启停是“真启停”。停用服务器会断开连接并注销其工具（mcp__<server>__*），这些工具对 Agent 运行时将不可见；启用则会重新连接并注册工具。 -
自动挂载
插件支持从<harness home>/mcp-servers.json读取服务器配置。只要在此文件中声明服务器，插件在启动时就会自动挂载为mcp-client实例。 -
本机配置源发现
面板底部提供“本机配置源发现”功能，可扫描 Claude Code 全局配置（~/.claude.json）、项目配置（~/.mcp.json）以及 Claude Desktop 的配置。它能探测本地地址的运行状态，并支持一键导入。 -
批量操作
提供工具栏“全部启用”和“全部停用”功能，支持对多个服务器进行批量管理。 -
持久化与 Headless 兼容
服务的禁用名单会持久化存储在<harness home>/mcp-manager.json中，重启后自动重新应用。同时，插件兼容 Headless 模式，即使没有 Web GUI 也能通过底层逻辑正常启停。 -
零构建
插件采用单文件结构（ESM host + ModuleLoader client），无需编译步骤即可直接使用。
安装与启用¶
使用该插件需要 DSH 版本 0.1.0-rc.7 及以上。安装过程如下：
- 通过命令行安装插件包。
# 方式一：从 npm 发布源安装
dsh plugin --profile web add dsh-mcp-manager
# 方式二：从 GitHub 直接安装（需确保代码已提交）
dsh plugin --profile web add github:welsione/dsh-mcp-manager
# 方式三：固定版本安装（推荐，避免 main 分支漂移）
dsh plugin --profile web add github:welsione/dsh-mcp-manager#v1.0.0
- 安装完成后，重启 DSH 进程。插件会自动进入
dsh.profile.bundles，并在 Web 界面的设置页加载管理面板。
使用方法¶
1. 自动挂载（推荐）¶
在 <harness home>/mcp-servers.json 中声明服务器。该插件兼容 Claude 的 mcpServers 风格配置。
{
"servers": {
"filesystem": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}
声明后，刷新页面或在面板点击“重新扫描”，新服务器会自动挂载。
2. Patch 实例挂载¶
如果需要更细粒度的控制，也可以在 profile 的 cordis.patch.yml 中添加 @deepseek-ai/dsh-mcp-client。
- insert:
- id: mcp-my-server
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: my-server
transport: stdio
command: npx
args: ['-y', '@some/mcp-server']
3. 导入本机配置¶
在“MCP 管理”面板底部的“本机配置源发现”区域，系统会列出本机已配置的 MCP 服务器。对于支持挂载的条目（如 stdio 或 streamable-http），点击“导入”即可将其写入 mcp-servers.json 并立即生效。
4. 热更新¶
对配置文件进行修改后，无需重启 DSH，直接在 Web 面板点击“重新扫描”即可实现增删和热更新。
注意事项¶
- SSE 协议限制：如果本机配置源中发现的是 SSE 协议的服务器（如 JetBrains IDEA 或 DataGrip 的 MCP 插件），界面会提示“暂不支持挂载”。这是因为 DSH 官方的
dsh-mcp-client目前仅支持stdio和streamable-http传输协议。 - 配置项隐藏：配置源发现 API 在展示配置时，不会返回配置文件中的
env或headers值，只显示是否存在。 - GitHub 安装机制：使用
github:前缀安装时，获取的是 GitHub 上已提交的代码。如果本地修改了代码但未git push，则无法通过该方式安装。
总结¶
dsh-mcp-manager 解决了在 DSH 中管理多个 MCP 实例的繁琐问题。通过 Web 界面实现了可视化的启停、批量操作以及配置发现，配合自动挂载和持久化机制，能够显著提升开发与调试效率。
- 仓库地址：https://github.com/welsione/dsh-mcp-manager
- 收录目录：https://www.skillhub.cn/plugins/welsione/dsh-mcp-manager
