前言¶
在 DeepSeek Harness（DSH）中，插件設置頁面通常只顯示 MCP 服務器是否已掛載。然而，底層客戶端在啓動錯誤時默認不會中斷進程，導致已掛載但未實際連接的服務器在 UI 中顯示爲“活躍”。這通常在智能體嘗試調用工具時纔會被發現。dsh-mcp-live-status 插件解決了這個問題，它直接在對話工具欄顯示服務器的實時連接狀態。
dsh-mcp-live-status 是什麼¶
dsh-mcp-live-status 是一個 DeepSeek Harness 插件，由 felix-lj-ct 維護。它主要解決“已掛載但未連接”的假健康狀態問題，幫助開發者快速識別 MCP 服務器的實際運行情況。
核心功能¶
該插件提供以下能力：
- 對話工具欄狀態顯示：在對話輸入框的工具行中顯示實時的連接狀態藥丸。
- 捕獲假健康狀態：能夠識別出已掛載但從未成功連接的服務器。
- 點擊查看詳情：點擊狀態藥丸可查看每臺服務器的傳輸方式、工具數量以及失敗原因。
- 零配置與只讀：無需額外配置，插件以只讀權限運行，僅用於狀態監控。
安裝與啓用¶
安裝該插件需要使用 web 配置文件，且 DeepSeek Harness 版本需爲 0.1.0-rc.7 或更高。
dsh plugin --profile web add dsh-mcp-live-status
安裝後，重啓 web 配置文件實例即可生效。
典型用法¶
使用該插件需要滿足以下條件：
- 環境要求：必須配置
web配置文件。 - 基礎依賴：至少配置一個 MCP 服務器。
- 會話觸發：狀態藥丸僅在會話存在時顯示。
- 主機狀態檢查：可以通過以下命令檢查主機端狀態：
curl 127.0.0.1:3080/dsh-mcp-live-status/status
注意事項與限制¶
在使用過程中，請注意以下限制：
- 顯示機制：狀態顯示依賴於會話，無會話時藥丸不可見。
- 輪詢機制：使用輪詢而非推送機制獲取狀態。
- 工具與連接的區分：插件無法區分“服務器未連接”與“服務器已連接但工具數爲零”。
- 權限範圍：插件爲只讀模式，僅讀取
loader、工具註冊表和webServer路由。 - 安全處理：會對 MCP 服務器命令行中的密鑰進行脫敏處理，防止泄露。
