dsh-mcp-hub
Manifest validImport existing MCP configurations from Claude Code, Claude Desktop, Codex, Cursor, VS Code / Copilot, Copilot CLI, Windsurf, Gemini CLI and OpenCode into DeepSeek Harness, search the official MCP reg
DSH MCP Hub
把散落在各个 AI 客户端里的 MCP 配置,收进 DSH 的一个页面:扫描导入、逐项验证、启停排障,密钥统一交给 DSH 凭证服务保管。

DSH MCP Hub 是 DeepSeek Harness 的设置页插件。它不替代官方 MCP Manager,而是在它之上提供一个更好用的管理面板:你能看到每个服务的真实连接状态、工具清单和失败原因,也能把 Claude Code、Codex、Cursor、Windsurf 等客户端里已经配好的服务一次性搬过来。
当前版本 0.2.x,面向 DSH 0.2.x(0.2.2 起)。
为什么需要它
MCP 配置通常藏在十几个 JSON / TOML 文件里,改一个命令要翻目录,密钥以明文散落,服务连不上时只能看日志猜。MCP Hub 把这件事收敛成三步:
- 导入——自动发现本机已知客户端的配置,或直接粘贴 JSON;
- 验证——用官方
probeServer真正握手、拉工具列表,通过才允许保存; - 托管——密钥写入 DSH 凭证服务,配置里只留引用;之后在页面里启停、复诊、看诊断。
功能
- 统一管理:添加、编辑、改名、启停、重启、复诊、删除官方 Manager 中的服务;异常项一键重连。
- 本机配置导入:扫描 Claude Code / Claude Desktop、Codex、Gemini CLI、VS Code / Copilot、Copilot CLI、Windsurf、Cursor、OpenCode,兼容 TOML / JSON / JSONC 与桌面端、CLI、Server 变体。
- 项目级发现:读取启动目录下的
.mcp.json、.cursor/mcp.json、.vscode/mcp.json等,导入时自动加名称后缀,避免跨项目重名。 - OAuth 登录:为支持 OAuth 的远程服务内置发现、动态客户端注册与 PKCE 授权;令牌写入 DSH 凭证服务,授权后自动重连,并在过期前刷新。
- 在线搜索:查询官方 MCP Registry,选 npm / PyPI / OCI / 远程 HTTP 后预填编辑页;不自动安装、不静默写入。
- 先测试再保存:逐行测试、批量一次性写入;失败零写入,已存在同名服务自动跳过。
- 后台验证:保存即关闭窗口,连接与工具注册在后台完成;失败自动停用并保留原因,不把失败显示成成功。
- 密钥不出现在配置里:明文在保存时写入 DSH 凭证服务,配置只保留
${credential:MCPHUB_…};支持就地显示 10 秒、复制、行内改密钥。 - 可分享的备份:导出默认不含密钥,含密钥时文件名明确标注;重新导入能识别“同名同连接、只是缺凭据”的情况。
- 跟随 DSH:中英双语、
--dsw-alias-*主题变量、深浅色与窄窗口适配,作为设置页的一部分存在。 - 无隐藏副作用:扫描只读配置、不执行启动命令;不修改来源应用的文件;不调用业务工具来探测权限。
安装
系统要求
- DSH 0.2.2 及以上(只覆盖 0.2.x;
engines.dsh为>=0.2.2-0 <0.3.0-0); - 只支持
stdio与streamable-http,sse明确不支持。
安装不需要 Node 或 npm;只有从源码运行、构建和测试时才需要。
方式 A:插件市场(dshmarket,推荐)
在 DSH 的 插件页 → 市场 搜索 dsh-mcp-hub,安装后打开 设置 → MCP Hub。
条目已于 2026-11-19 收录。如果本机市场缓存里还没有,重启 DSH 后再搜,或改用方式 B。
方式 B:Release 安装(手动 / 离线)
-
下载 dsh-mcp-hub.tgz;
-
桌面应用:插件 → 添加插件 → 选择这个
.tgz文件(或填入它的绝对路径); -
CLI:
dsh plugin --profile <profile> add "$HOME/Downloads/dsh-mcp-hub.tgz" -
按桌面提示重启,或重启对应的
dsh web;打开 设置 → MCP Hub。
Release 包走 files 白名单,使用宿主自带的官方依赖,是“用户实际装到的包”的真实形态。
方式 C:源码 link(开发 / 调试)
git clone https://github.com/mr-hanlu/dsh-mcp-hub.git
cd dsh-mcp-hub
npm ci
npm run build # 生成 lib/client.js 与 lib/style.css,插件页加载的就是这两个文件
桌面应用:添加插件 → 输入仓库的绝对路径。CLI:
dsh plugin --profile hub-dev add "$PWD"
本地目录是 link 安装:改代码后需要重新 npm run build 并重启 DSH 才会生效。
升级与卸载
- 市场:插件行上出现 Update 时点一下即可;卸载也在市场卡片里。
- Release:下载新版本
.tgz重新添加,同一插件会被替换,配置与密钥保留。 - CLI:
dsh plugin --profile <profile> remove dsh-mcp-hub。
npm 上的
dsh-mcp-hub是他人占位包,不是本项目。 不要用dsh plugin add dsh-mcp-hub按包名安装。GitHub 源码安装是 DSH 官方支持的安装方式,本仓库也可以。 插件页的「添加插件」接受 npm 包、本地路径、Git 地址和 tarball;Git 地址会按 pnpm 的 git 依赖安装,DSH 安装前还会用
git ls-remote检查仓库。本仓库已把lib/构建产物一起提交,所以github:mr-hanlu/dsh-mcp-hub能加载完整的设置页。源码安装不会自动更新,升级仍建议用市场或 tarball;如果你是改源码的人,先npm run build,再把lib/一起提交,否则安装后的页面会缺前端。
装好后确认
- 列表显示官方 Manager 已有服务,且不重复列出插件注册的服务;
- 加一个 stdio 服务:测试连接 → 保存 → 行状态变为「验证通过」,工具数与详情一致;
- 需要 Bearer token 的远程服务:配置里是
${credential:MCPHUB_…}而不是明文,点「显示」能读回值。
兼容性
package.json的engines.dsh(>=0.2.2-0 <0.3.0-0)是唯一判据,不满足时 DSH 拒绝加载并列出未满足项。- 官方
@deepseek-ai/*包声明为peerDependencies,devDependencies只供本地构建;link 安装会优先用仓库的 dev 副本,只有 tarball / 市场安装才真正使用宿主副本。判断宿主兼容性请以 Release 安装为准。 - 确需跨版本范围验证时,使用官方版本豁免(
dsh plugin allow-version,升级后需重新授权)。
使用
三个页签:已添加、本地导入、在线搜索。完整说明(扫描范围、验证口径、密钥与导出规则、配置项)见 使用说明。
安全与边界
- 扫描只读取配置文件和检查访问权限,不执行里面的启动命令;
- 不修改、不持续同步来源应用配置;导入是一次性复制;
- 插件注册的服务只读,继承配置只能停用;不迁移其他 MCP 管理插件的数据;
- 远程服务支持静态 env / headers、DSH 凭证引用与 OAuth 登录;单工具权限仍不在范围内。
- 单工具权限管理与 Tool Search 不在本版本范围,界面不保留占位入口。
文档
| 文档 | 内容 |
|---|---|
| 使用说明 | 导入、验证、密钥、在线搜索、配置项与已知边界 |
| 测试说明 | 每层测试做什么、怎么跑、需要什么环境 |
| 开发进度 | 已完成能力、验证记录与已知问题 |
| 后续任务 | 按优先级排列的下一步工作 |
| 桌面验收清单 | 只能人工确认的主题、窄窗与官方 Manager 边界 |
| 开发计划 | 认证分层与 OAuth 方案(历史快照) |
| 文档索引 | 全部文档的用途与阅读顺序 |
开发
npm ci
npm run build
npm test # 单测
npm run check # 语法与共享层检查
npm run dev # 本地预览 http://127.0.0.1:4173(仅开发辅助,不能替代真实验收)
端到端测试建临时 DSH_HOME、启动真实 Host 或无头 Chrome;怎么跑、环境变量和常见失败见 测试说明。
License
Comments
Loading…
Similar plugins
DSH MCP Connectors — cross-agent MCP server manager or DeepSeek Harness
★ 0
Apache-2.0
TypeScript
dsh plugin --profile web add dsh-mcp-connectorsby Relistencode
Manage DSH(DeepSeek Harness)) skills and MCP servers: CLI + settings-page UI with zh/en i18n, Claude/Codex import, and update checks.
★ 9
↓ 287/wk
MIT
JavaScript
Aug 21, 2026
dsh plugin --profile web add dsh-extension-hubby YunzhouLi-hub
Host-wide MCP server panel: imports the servers declared in Claude Desktop, Claude Code, Cursor and Codex CLI configs, searches six upstream catalogs and installs from whichever of them declares an in
★ 26
MIT
JavaScript
Nov 20, 2026
dsh plugin --profile web add dsh-overall-mcpby CoderKuo
Manage the MCP servers of a DeepSeek Harness profile: status, switch, edit, export; add from the official MCP Registry, by hand (tested first), or with AI; find local software that can be connected
★ 3
↓ 118/wk
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-mcp-consoleby appthin
MCP management page in DSH Settings: list, enable/disable, restart and delete MCP servers, edit them in form or JSON mode, expand a server to see the tools it registers, and paste-import MCP configs f
★ 30
↓ 1.1k/wk
MIT
JavaScript
Nov 11, 2026
dsh plugin --profile web add dsh-mcp-manager-plusby shiliu153
DeepSeek Harness bundle: manage MCP servers — list, probe, add from pasted project references, toggle, remove, rotate credentials. Official dsh-mcp-client contract compliant.
★ 0
NOASSERTION
JavaScript
Nov 2, 2026
dsh plugin --profile web add @dsh-contrib/dsh-mcp-manager