前言¶
在 DeepSeek Harness（DSH）里接 MCP，常见情况是：本机 Claude Desktop、Cursor、VS Code 等已经配过一批 server，但 DSH 侧还要手工对照 JSON 再录一遍；想找新 MCP，又要在官方 Registry、Smithery、各类 Awesome 列表之间来回切。下面介绍社区插件 dsh-overall-mcp（维护者 YunzhouLi-hub），它把「本机已有配置的发现与登记」和「多源目录聚合、一键安装」放在同一块侧栏面板里，并维护本地 GitHub MCP 仓库普查索引，用于补全安装命令来源。
这是什么¶
dsh-overall-mcp 是 DSH 的联网工具类插件（当前版本 0.12.8，MIT 许可证）。一句话定位：首次安装时扫描整机各产品的 MCP 配置并自动登记；并行聚合六个开放 MCP 目录（README 记载 2026-10 实测去重后 5,364 条）；在本地维护 GitHub MCP 仓库普查索引（同文档记载 1,758 行），并从仓库证据恢复安装命令并标注来源。
插件出现在 DSH 侧栏 Plugins 下方的 Global MCP 全局面板（不是插件配置页里的零散设置项）。
核心功能¶
首次安装：整机配置扫描¶
首次加载会对下列环境的 MCP 配置做发现并登记：
- Claude Desktop、Claude Code
- Cursor
- VS Code（Copilot）
- Windsurf
- Codex CLI、Gemini CLI
登记结果在 Registered 标签页按来源分组展示，支持折叠、按组开关、状态筛选。
MCP Market：六源合一¶
市场标签页在一个搜索框后聚合六路目录（并行拉取、去重计数）：
| 来源 | 说明（据 README） |
|---|---|
| 官方 Registry | 开放注册表 |
| Smithery | 第三方目录 |
| Docker MCP Catalog | 容器镜像类条目 |
| GitHub MCP | 读本地普查索引；有索引时对 GitHub 零请求 |
| Awesome remote | 远程列表 |
| Awesome list | 列表类收录 |
无关键词也可浏览；可按来源筛选、关键词搜索。GitHub 源在无安装数据的行上，会依据仓库证据恢复命令，并标明证据来源。筛选里另有 local census (index)：只读磁盘已有索引，不触发重新 walk，计数仍归属 GitHub 源（同一上游、同一套数字）。
一键连接与启动方式映射¶
README 记载的映射规则：
- npm 包 →
npx -y <pkg> - Python 包 →
uvx - 托管端点 → streamable-http
- Docker 镜像 →
docker run -i --rm mcp/<name> - 仅列表、无安装信息的条目提供仓库链接
安装前配置（API Key 等）¶
能从官方 Registry（或条目自带 launcher）读到声明时，会随条目保存；缺必填密钥时显示 待配置 徽标和一行页内提示，配置 打开掩码表单。保存后仅重挂载已启用的对应行；安装接口返回后也会为刚写入的 server 打开配置表单（GET /servers、POST /configure，工具名 overall_mcp_configure）。
原生工具桥接¶
每个已启用的 server 通过 dsh-mcp-client 挂载，其 tools 注册为 DSH 原生工具，命名形如 mcp__<name>__<tool>。
按来源组批量开关¶
每个来源组一个总开关，可一次性启用/禁用该组下全部 server（亦可通过 overall_mcp_set_source_enabled 调用）。
版本检查与批量更新¶
对经 npx / uvx 启动的 server（含 Windows 下 cmd.exe /c 包装）检查 npm/PyPI 版本；面板提供 Update all (N) 队列更新并显示逐行进度，完成后变为 ✓ done。
身份行与运行状态¶
面板第二行展示当前进程实际运行的代码信息：插件版本、pid、运行时长、可读数据文件路径、日志行等。若磁盘上的代码比当前进程新，会提示 ⚠ code updated, restart DSH，便于区分「未加载」与「需重启」。
操作日志¶
宿主将扫描、目录拉取、配额、普查、证据恢复、安装、更新、挂载、注册表修复等动作写入 events.ndjson（仅元数据、不含密钥，保留最近 400 行），可从页头展开查看。
GitHub 凭证与普查 / 证据恢复¶
可在面板粘贴 token，或使用 gh auth token；校验通过后才生效，且仅发往 GitHub 主机。无 token 仍可用，但 API 预算为 60 次/小时（有 token 为 5,000 次/小时）。普查遇网络失败会按仓库重试与退避，多次拒绝后停止；下次从断点继续（GET|POST|DELETE /auth）。
Registered 页的 GitHub 卡片可查看普查进度（行数、上次读取、停止原因），并手动 start / stop；停止安全，行随到达写入，下次只补缺失仓库（GET|POST /census）。同卡片还有第二条 证据恢复 walk：从仓库内容恢复安装命令，可显示如 tried 78 / 2.1k repositories，未完成时可 resume recovery（GET|POST /install-evidence）。README 说明完整遍历量级约为两千余仓库、约 150ms/库，且已不再在市场打开时自动全量跑满。
数字与时间的含义¶
各源计数与总计使用同一去重规则（单独展示 deduped）；「listing read at」为本地读取时间，「upstream updated」为仓库最后 push；按使用量排序时无数据的卡片会明示；推断类目在卡片、详情与类目下拉中标注 (inferred)。
安装与启用¶
运行环境要求 Node ^22.19.0 || >=24.0.0（见 package.json 的 engines）。
README Quick start 给出的安装方式为本地路径添加（需先取得插件目录，例如从 GitHub 发布包或克隆后的路径；本文不展开 clone 步骤）：
dsh plugin --profile web add ./dsh-overall-mcp
添加后重启对应 profile：首次加载会扫描本机 MCP 配置，侧栏 Plugins 下出现 Global MCP 入口。
社区目录页（非 DeepSeek / 幻方官方商店，仅为 DSH 生态独立站点）：skillhub.cn 上的 dsh-overall-mcp。若目录页提供的安装命令与 README 不一致，以你实际打开页面时的原文为准；勿自行拼接未在文档出现的 github:owner/repo 形式。
典型用法¶
- 安装并重启 profile，等待首次扫描完成。
- 打开侧栏 Global MCP → Registered：按来源查看已导入的 server，用组开关或单行开关控制启用；缺密钥的条目点 配置 补全。
- 切换到 MCP Market：按来源或关键词找条目，在详情页复制安装命令或一键安装；需要 GitHub 普查或证据恢复时，在 Registered 的 GitHub 卡片上按状态选择 start / stop 或继续恢复。
- 在 DSH 对话或自动化里使用已挂载工具，名称格式为
mcp__<server名>__<tool名>。 - 对
npx/uvx类 server 定期用面板的版本检查与 Update all 更新。
更细的工程取舍与实测记录见仓库 docs/ENGINEERING.md；从 GitHub 安装一次的耗时与 lockfile 说明见 docs/install-check.md。插件未发布到 npm，以 GitHub 仓库为准。
适用场景与注意¶
适合谁：已经在多台客户端工具里散落配置了 MCP、希望在 DSH 里统一登记与开关；或需要在一个面板里搜六个开放目录、并依赖本地 GitHub 索引补安装命令的开发者。
权限与安全：插件以当前 DSH 进程的权限运行，扫描读本机配置、安装命令会执行 npx、uvx、docker 等。安装前请阅读源码与 MIT 许可证，确认仓库来源可信；向面板提交 GitHub token 时理解其仅用于 GitHub 主机且经校验后生效。
数据与网络：目录与普查会访问外部服务并受各源配额限制；无 token 时 GitHub 预算较低。操作日志不写密钥，但仍建议在共享环境中注意日志与数据文件路径（身份行中会列出可读路径）。
结尾¶
dsh-overall-mcp 把整机 MCP 配置的首次扫描、多源市场浏览与一键安装、GitHub 普查与安装命令证据恢复，收敛到 DSH 侧栏的一块 Global MCP 面板，并通过原生 mcp__* 工具名把已启用 server 接到 Harness 工具链上。
- 社区目录：https://www.skillhub.cn/plugins/YunzhouLi-hub/dsh-overall-mcp
- 源码与 README：https://github.com/YunzhouLi-hub/dsh-overall-mcp（README 含中文版 README.zh-CN.md）
