前言¶
DeepSeek Harness 採用插件化架構。要使用 Model Context Protocol (MCP) 服務器,開發者通常需要手動配置或編寫腳本。meltartica/dsh-mcp-servers 是一個 DSH 插件,它將 MCP 服務器作爲原生工具暴露,並提供了一套設置 UI、實時狀態監控、自動重連以及通過本地文件或 WebDAV 進行備份/恢復的功能。
核心功能¶
該插件集成了 MCP 服務器連接與管理的客戶端功能,主要特性如下:
- 多傳輸協議支持:支持 stdio、streamable http 和 legacy SSE 三種傳輸方式,在 UI 中通過統一的端點字段配置。
- 工具自動註冊:工具自動註冊爲
mcp__<serverId>__<toolName>格式,遵循官方 MCP 客戶端的命名規範。 - 狀態監控與重連:提供實時狀態指示點(綠色連接,紅色失敗),並在連接斷開時自動嘗試重連(帶退避策略)。
- 測試與編輯:每張服務器卡片包含測試按鈕,可探測連接與工具列表;支持編輯命令、參數、環境變量或 HTTP 頭部。
- 備份與恢復:提供本地 JSON 導出/導入,以及 WebDAV 同步(支持 HTTPS 和 Basic Auth,可設置每日自動備份)。
安裝與啓用¶
使用 DeepSeek Harness CLI 進行安裝:
dsh plugin --profile <name> add ./dsh-mcp-servers
dsh --profile <name>
安裝後,啓動 Harness,進入設置菜單的 MCP Servers 選項卡。
典型配置示例¶
在設置界面中添加服務器,點擊 Test 驗證連接,最後點擊 Save 保存。
1. 配置 Stdio 服務器¶
適用於本地運行的 Node.js 進程。
- Type:
stdio - Command:
npx - Command Args:
-y和@modelcontextprotocol/server-everything(每行一個參數) - Env: 鍵值對,例如
API_KEY/your_token
2. 配置 HTTP/SSE 服務器¶
適用於遠程 API。
- Type:
http或sse - URL:
https://example.com/mcp - Headers: 鍵值對,例如
Authorization/Bearer ...
3. 備份與恢復¶
在 Backup & Restore 標籤頁中,可以將當前服務器列表導出爲 JSON 文件,或在需要時導入恢復。支持通過 WebDAV 進行雲端同步,並可選每日 12:00 PM 自動備份。
注意事項¶
- Schema 限制:工具的輸入 Schema 會經過白名單過濾,僅保留 Harness 支持的 JSON Schema 子集。不支持的關鍵字(如
minLength,format,anyOf等)會被丟棄。 - 渲染方式:MCP 返回的結果以文本形式渲染;圖片或資源塊會摺疊爲 JSON 或文本,不顯示爲富文本塊。
- WebDAV 限制:WebDAV 僅支持 HTTPS 端點;URL 中不允許包含憑據,需單獨輸入;同步路由僅限迴環訪問。
- 運行權限:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。
結語¶
該插件簡化了 MCP 服務器在 DeepSeek Harness 中的接入流程,提供了完整的生命週期管理能力。更多詳情與源碼,請訪問 GitHub 倉庫。