mcp-hub:用一块 TUI 与 DSH 工具统一盘点、审计 MCP 配置

前言

在 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 嵌进智能体工作流,同时避免把原始密钥与命令行参数灌进对话。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye