前言¶
在本地開發環境中，開發者通常會在 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 或 社區目錄。
