前言¶
在 Claude Desktop、Cursor、VS Code、Claude Code 里分别装上 MCP 服务之后，配置会散落在不同路径里：有的连不上，有的在明文里放了 token，还有的重名、重复。手动翻配置文件很难一眼看清全局，也很难在改机或换客户端时做一致的导出与迁移。
mcp-hub 由维护者 jiale-cheng-ning 开发，归类为 admin-security。它提供 Rust 编写的独立命令行与终端 TUI，并附带 DeepSeek Harness（DSH）插件包，用于在对话里做受限报告的扫描、审计与健康检查。社区目录页见 SkillHub（与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态中的第三方收录）。
这是什么¶
一句话：One TUI to manage all your MCP servers——发现、监控并审计跨客户端的 MCP 服务配置。
底层是单个 Rust 二进制，无运行时依赖。仓库同时发布 npm 包 @jiale-cheng-ning/dsh-mcp-hub（当前资料中版本为 0.1.0，MIT 许可证），通过 cordis.patch.yml 向 DSH 注册主机侧插件，暴露三个对话工具，不单独提供 Web 设置页。
核心功能¶
下列能力均来自项目 README 与 DSH 插件文档，按使用形态区分。
命令行与 TUI¶
| 能力 | 说明 |
|---|---|
| TUI 仪表盘 | 浏览、检查、筛选 MCP 服务；按 t 切换深/浅主题 |
| 自动发现 | 扫描 Claude Desktop、Claude Code、Cursor、Windsurf、VS Code，以及 DSH（$DSH_HOME/cordis.patch.yml 与 profiles） |
| 安全审计 | 15 条静态规则（拼写相似包名、已知 CVE、postinstall、危险命令、明文密钥、Shell 注入等） |
| MCP Doctor | 拉起服务、校验握手、统计 tools |
| Benchmark | 测启动时间、初始化延迟、tools/list 响应；支持 MCP 2026-07-28 与 legacy stdio / Streamable HTTP |
| 注册表搜索 | 搜索官方 MCP Registry，可一键安装到指定客户端 |
| 导出 / 导入 / 同步 | 导出 Git 友好 JSON（密钥脱敏）；sync / import 对不可读目标配置拒绝写入，并用临时文件原子替换，备份名为 <config>.<process>.<id>.bak（备份可能含凭据，需自行保管） |
DSH 对话工具¶
需另行安装与本仓库匹配的 Rust 二进制（旧版无 report 子命令时插件会报错）：
| 工具 | 作用 |
|---|---|
mcp_hub_scan |
可选 client：列出名称、客户端、传输与配置状态；不启动服务 |
mcp_hub_audit |
可选 client：静态安全规则与严重级别；不启动服务 |
mcp_hub_doctor |
必填 server，可选 client、timeout（默认 5 秒，1–30）：对一个命名服务做协议探测 |
client 取值包括：claude-desktop、claude-code、cursor、vscode、windsurf、dsh。省略则扫描所有受支持位置。项目级配置相对当前智能体会话的工作区解析，而非 DSH 安装目录。报告通过 mcp-hub report 输出 version-1 JSON，省略原始环境变量、URL、命令参数等；扫描与审计最多 200 行，输出有体积与 45 秒超时限制。
安装与启用¶
安装 Rust 命令行（通用）¶
推荐一行脚本（Linux / macOS）：
curl -fsSL https://raw.githubusercontent.com/jiale-cheng-ning/mcp-hub/master/install.sh | sh
也可从 GitHub Releases 下载预编译包，或：
cargo install --git https://github.com/jiale-cheng-ning/mcp-hub
安装 DSH 插件（主机侧）¶
要求：Node.js 20.11+、带 tools 服务的 DSH、pnpm，以及从本仓库构建并安装的 mcp-hub 二进制。
在仓库根目录执行：
cargo install --path . --locked
npm pack
npm pack 会生成 jiale-cheng-ning-dsh-mcp-hub-0.1.0.tgz。安装到实际使用的 profile（示例为 web）：
dsh plugin --profile web add ./jiale-cheng-ning-dsh-mcp-hub-0.1.0.tgz
安装后重启该 profile。插件不会自动下载 Rust 可执行文件。
若二进制不在 DSH 的 PATH 中，在启动 DSH 之前设置绝对路径，例如 Linux / macOS：
export MCP_HUB_BIN="$HOME/.cargo/bin/mcp-hub"
dsh web
也可在主机配置中使用 { "binary": "/absolute/path/to/mcp-hub" }。相对路径会被拒绝；模型侧不能指定二进制路径或 shell 命令。
典型用法¶
终端里集中运维¶
mcp-hub # 启动 TUI
mcp-hub scan # 表格列出所有服务
mcp-hub scan --json # 供脚本使用
mcp-hub audit # 安全审计
mcp-hub audit --json # 供 CI 使用
mcp-hub doctor # 协议连通性检查
mcp-hub bench # 性能基准（默认 3 轮）
mcp-hub search postgres --install --target cursor
mcp-hub export
mcp-hub import mcp-hub.json --target cursor
mcp-hub sync --from cursor --to dsh
mcp-hub preset install web-dev --target dsh
TUI 中 Servers 页用 j/k 移动、Tab 切换 Audit 页；Audit 页用 1/2/3 切换 Critical / Warning / Info 筛选。
在 DSH 对话里¶
可按自然语言触发，例如文档中的示例：
- 「用 MCP Hub 扫描我的 MCP 配置。」→
mcp_hub_scan - 「用 MCP Hub 检查 MCP 配置的安全问题。」→
mcp_hub_audit - 「检查 Cursor 中名为 github 的 MCP 服务能否连接。」→
mcp_hub_doctor（server须与扫描结果中的名称完全一致）
Doctor 会执行配置中的 stdio 命令或连接 HTTP 端点，仅在用户明确要检查时调用；不调用业务工具、不修改配置。
适用场景与注意¶
适合谁： 同时在多个 IDE / 客户端里使用 MCP、需要统一视图、迁移配置、或在提交前做静态安全扫描与单点连通验证的开发者与团队。admin-security 类场景（密钥暴露、危险参数、重复配置）与 README 中的 15 条规则直接对应。
权限与安全： DSH 插件以当前 dsh 进程权限运行；mcp_hub_doctor 会启动子进程或发起网络连接。安装前应阅读仓库源码与 MIT 许可证，确认审计规则与报告脱敏策略符合你的合规要求。审计为启发式检查，不能替代完整漏洞评估或「已证明安全」的保证。
与独立 CLI 的关系： 日常大批量操作、TUI、bench、sync 等仍适合直接用 mcp-hub；DSH 插件侧重在对话中给出有界、可编程的结构化结果，且依赖本机已安装的兼容二进制。
结尾¶
mcp-hub 把分散在多客户端的 MCP 配置收到同一套发现、审计与（可选）探测流程里；DSH 侧则用三个工具把扫描、审计、Doctor 嵌进智能体工作流，同时避免把原始密钥与命令行参数灌进对话。
