前言¶
在 DeepSeek Harness (DSH) 中,MCP 服務的配置通常寫在 cordis.patch.yml 文件中。手動維護時,僅能通過配置文件確認服務是否存在,無法驗證服務端是否真正連通。dsh-mcp-manage 插件在設置頁面增加了一個“MCP 服務”管理入口,支持對服務器進行增刪改查,並執行真實的 MCP initialize 握手以驗證連接狀態。
它是什麼¶
這是一個靜態 DSH 插件。它爲 DSH 的設置界面新增了一個 MCP 服務管理頁面,用於管理 cordis.patch.yml 中註冊的服務器。插件會對每個服務發起真實的 MCP 初始化握手,以確認服務是否正常運行。
核心功能¶
- 管理頁面:在 Settings 中新增“MCP 服務”頁面。
- 增刪改查:支持列出、添加、編輯和刪除
cordis.patch.yml中的 MCP 服務器配置。 - 連接驗證:運行真實的 MCP
initialize連接握手,檢查每個服務是否連通。 - 持久化寫入:將配置變更直接回寫到
cordis.patch.yml。 - 自動協調:自動協調
dsh.profile.bundles。 - 傳輸支持:支持
streamable-http和stdio兩種傳輸方式。
安裝與啓用¶
安裝此插件必須使用 dsh plugin 包裝器,不能直接使用 pnpm add。
dsh plugin --profile web add dsh-mcp-manage
安裝完成後,需要重啓 DSH(例如停止並重新啓動 dsh web)以加載插件。重啓後,進入 Settings → MCP 服務 即可使用該功能。如果頁面未顯示,請嘗試硬刷新瀏覽器(Ctrl/Cmd + Shift + R)。
注意事項¶
- 依賴環境:需要 Node.js >= 18,以及
@deepseek-ai/cordis>= 4.0.1。 - 安裝方式:必須通過
dsh plugin命令安裝,以確保在重啓後正確加載。 - 運行環境:這是一個靜態插件,在 DSH 的正常平面運行,而非在沙盒中運行。
- 許可證:MIT 許可證。
結語¶
dsh-mcp-manage 解決了 DSH 開發者無法直觀驗證 MCP 服務連通性的問題。通過在設置中提供可視化的管理界面和真實的握手檢測,它簡化了服務的調試與維護流程。更多詳情與源碼,請參考 GitHub。