前言¶
在本地开发环境中，开发者通常会在 Claude Code、Codex 或 CodeBuddy 等智能体中配置多个 MCP (Model Context Protocol) 服务器。配置文件通常只包含命令行参数和地址，无法确认这些服务是否真正可用。DeepSeek Harness (DSH) 插件生态允许我们扩展功能，下面介绍 dsh-scan-mcp，它填补了这一空白。
插件介绍¶
dsh-scan-mcp 是一个 Windows 专用的 MCP Hub 插件，由 chenbin-dev 维护。它的核心功能是从本地编码代理的配置文件中自动发现 MCP 服务器，并通过真实的 MCP initialize 握手（支持 stdio 和 streamable-http 两种传输协议）探测连接状态，最后在 UI 中提供启用/禁用和管理功能。
核心功能¶
- 自动扫描配置：读取 Claude Code (
~/.claude.json)、Codex (~/.codex/config.toml) 和 CodeBuddy (~/.codebuddy/mcp.json) 中的 MCP 配置，并进行跨代理去重，同一 MCP 仅显示一次。 - 真实连接探测：对 stdio 传输启动实际进程，对 streamable-http 传输执行真实的 HTTP
POST请求，解析 JSON 和 SSE 响应，验证服务器在线状态。 - 仅探测已启用项：只有处于启用状态的 MCP 服务器才会被连接探测；已停用的服务器显示为离线且不进行探测。
- 交互式管理：提供
/mcp弹窗面板和设置页面的滑动开关，支持对单个服务器进行重新连接测试。 - 工具暴露：在模型侧暴露
mcp_discovered_catalog工具，用于读取扫描结果和连通性信息。
安装与启用¶
安装前请确保环境满足要求：Windows 系统、DeepSeek Harness (DSH) 带有 web profile (dsh web)、以及 Node.js >= 20。
- 执行安装命令（替换
<profile-name>为你的 DSH profile 名称，例如web）：
dsh plugin --profile <profile-name> add dsh-scan-mcp
- 安装完成后，重启 profile（例如重新运行
dsh web）。插件以静态包形式存在，无需每次会话审批。
典型用法¶
- 控制面板：在任何会话中输入
/mcp，即可弹出 MCP 控制面板。面板中展示去重后的 MCP 数量、在线/离线/已停用状态、端点信息以及失败原因。 - 设置页面：前往 Settings → Windows MCP 控制中心，以卡片布局查看所有 MCP 服务器。
- 模型工具：在模型对话中，模型可以直接调用
mcp_discovered_catalog工具获取完整的 MCP 目录信息。
适用场景与注意¶
- 适用场景：Windows 环境下，同时使用 Claude Code、Codex、CodeBuddy 等智能体，需要统一管理其 MCP 服务连通性的开发者。
- 注意事项：
- 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT）。
- 隐私安全：插件仅显示环境变量和 Header 的名称，绝不会读取或显示凭证的实际值。
- 探测行为：探测过程仅限 MCP
initialize握手，不会调用 MCP 的工具，也不会留下运行中的进程。 - 状态持久化：启用的开关状态会持久化保存到
~/.dsh/dsh-scan-mcp.json。
结语¶
dsh-scan-mcp 为 Windows 下的 DSH 用户提供了可视化的 MCP 服务管理能力。通过真实的握手探测和 UI 控制，解决了配置与实际连通性脱节的问题。更多详情请访问 GitHub 或 社区目录。
