前言¶
在 DSH 里接 MCP，常见做法是手改 profile 里的 dsh-mcp-client 注册块：transport 选 stdio 还是 streamable-http、环境变量和 header 的类型、服务名全局唯一等，错一处客户端启动就会报错，改起来也不直观。
下面介绍社区插件 dsh-mcp-hub（维护者 tang-coder-hub，分类：客户端）。它在 DSH「设置 → MCP 服务器」提供表单化配置，校验通过后写入 profile，并支持探测连通性与工具列表；协议层只依赖 DSH 自带的 @deepseek-ai/dsh-mcp-client，插件本身不做 MCP 协议实现。
这是什么¶
dsh-mcp-hub 是通用 MCP 服务器管理页，版本 1.0.0（MIT 许可证，Node >=20）。解决的问题是：在图形界面里增删改任意 MCP 服务（stdio 或 streamable-http），一键落盘到 profile 的注册块，重启 DSH 后在会话里使用对应工具。
社区目录页：SkillHub — tang-coder-hub/dsh-mcp-hub。源码与说明：GitHub — tang-coder-hub/dsh-mcp-hub。SkillHub 为独立社区站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装方式以 Harness 读取的安装计划为准。
核心功能¶
目录优先的预设¶
页面顶部是一排服务卡片，点选即可添加。内置四个预设，端点均指向厂商文档中明确给出的地址，不猜测、不代填：
| 服务 | 端点 | 凭证 |
|---|---|---|
| GitHub | https://api.githubcopilot.com/mcp/ |
fine-grained PAT |
| Notion | https://mcp.notion.com/mcp |
Internal Integration Token |
| Linear | https://mcp.linear.app/sse |
Personal API Key |
| Sentry | https://mcp.sentry.dev/mcp |
Auth Token |
选服务后会出现凭证面板，带「在浏览器打开凭证页」按钮，跳转到厂商自己的 token 创建页；粘贴回来保存，再「应用到 DSH」。
自定义与高级¶
目录刻意保持很小。若要接其他 MCP，使用底部「自定义 / 高级」表单，stdio 子进程与任意 URL 均可填写。
校验与落盘¶
插件 bundle id 为 mcp-hub，生成的配置行落在 mcp-hub__<服务名> 命名空间，避免与 loader 条目或其它补丁层静默替换。应用前做整体校验：任一字段无效则整体拒绝且不写盘，避免留下半个块。
宿主侧将所有 env / headers 值强制转为字符串，YAML 标量一律加引号，以满足官方客户端对 {[key]: string} 的要求。serverName 在列表内查重，并与官方 pattern 一致，避免客户端启动时报全局唯一冲突。
桌面宿主不导出 DSH_PROFILE_DIR 时，profile 目录从 process.argv 解析，来源会在页面上显示。
探测¶
保存前可点「探测」，真实握手一次：
- stdio：作为子进程启动，执行
initialize与tools/list，读取 stdout；成功时列出工具数量。 - streamable-http：发送 JSON-RPC 握手；非 200 会带上状态码，401/403 明确提示凭证无效，超时单独报
timeout。
会话中工具命名形式为 mcp__<服务名>__<工具名>。
安装与启用¶
在 SkillHub 插件页可将安装意图发给 DeepSeek Harness，由 Harness 读取后端安装计划后执行。目录页给出的表述为：
请安装 DSH 插件 tang-coder-hub/dsh-mcp-hub。
安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，只安装你信任的来源。
启用后，在 DSH 中打开 设置 → MCP 服务器 即可使用管理页。
典型用法¶
按 README 中的步骤操作：
- 设置 → MCP 服务器 → 在目录里点选一个服务（或走自定义表单）。
- 在凭证面板点「↗ 在浏览器打开凭证页」→ 在厂商页面创建 token → 粘贴回来 → 保存。
- （可选）点「探测」，确认握手成功并看到工具数量；401 表示凭证无效。
- 点 应用到 DSH → 重启 DSH。
- 在会话里使用
mcp__<服务名>__<工具名>形式的工具。
凭证会以明文写在 profile 的补丁文件里（官方 @deepseek-ai/dsh-mcp-client 的工作方式），页面会提醒。若需降低风险，可使用只读 scope 的 token，或只授权必要仓库。
适用场景与注意¶
适合谁：经常在 DSH 里切换或新增 MCP（GitHub、Notion、Linear、Sentry 或自研 stdio/HTTP 服务），希望少手改 YAML、并在写盘前做校验与探测的开发者。
工程侧：仓库提供离线验证脚本，共 60 项检查（无需 DSH 运行时）：
node scripts\verify.mjs
或在 package.json 中：
npm run verify
检查项包括：生成 YAML 用真实解析器回读并逐字段断言类型、stdio/HTTP 探测路径、无效配置阻止 apply 时不触碰 profile、无 DSH_PROFILE_DIR 时仍能定位 profile 目录等。
注意：本插件不实现 MCP 协议，只负责表单、校验与 profile 补丁；远端端点与凭证策略以各厂商文档为准。安装与升级请通过 Harness 与目录页指引，勿假设未在文档中出现的 CLI 拼写。
结尾¶
dsh-mcp-hub 把 MCP 注册块收进 DSH 设置页：官方客户端承载连接，插件负责配置落盘与探测，并内置四个厂商端点预设。需要表单化管理 MCP 时，可从目录页发起安装，按上文步骤配置并重启后即可在会话里调用工具。
- 目录页：https://www.skillhub.cn/plugins/tang-coder-hub/dsh-mcp-hub
- GitHub：https://github.com/tang-coder-hub/dsh-mcp-hub
