前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在本地開發或部署智能體時,管理 MCP (Model Context Protocol) 服務器的配置往往需要手動編輯 YAML 文件或重啓服務,這增加了調試成本。dsh-mcp-servers 插件解決了這個問題,它爲 DSH 的 Web 界面提供了一個設置頁面,允許用戶通過 JSON 編輯器管理配置,並自動掛載活躍的 mcp-client 實例。
這是什麼¶
railgun52/dsh-mcp-servers 是一個配置頁面插件,屬於客戶端類別。它通過一個 JSON 編輯器覆蓋 profile-config 命名空間,用於保存服務器列表,並掛載從這些列表中讀取的活躍 mcp-client 實例。該插件由 railgun52 維護,擁有 1 個 Star,並採用 MIT 許可證。
核心功能¶
設置頁面¶
在 Web 界面的設置中新增一級分區「MCP 服務器」。該分區提供了添加、編輯和移除服務器的卡片列表。
JSON 編輯器¶
用戶可以直接在文本框中編輯整個 servers 數組。通過點擊添加服務器,可以快速完成配置。
實時橋接¶
插件會在主機端爲每個啓用的服務器掛載一個 mcp-client 實例。每次編輯設置後,橋接層會自動同步(re-sync),無需重新掛載插件即可生效。
傳輸協議與配置¶
支持兩種傳輸方式:stdio 和 streamable-http。每個服務器配置包含以下字段:
* name: 服務器名稱
* command: 啓動命令
* args: 命令參數
* env: 環境變量
* transport: 傳輸類型
* url: HTTP 地址(當傳輸類型爲 streamable-http 時)
* enabled: 是否啓用
數據持久化¶
配置值會持久化保存到當前激活的 Profile 的插件配置中。
安裝與啓用¶
安裝此插件需要使用 npm 包。在終端中執行以下命令:
dsh plugin --profile web add @railgun52/dsh-mcp-servers@latest
命令執行完畢後,必須重啓 dsh web 才能加載新的插件。
典型用法¶
- 重啓
dsh web後,打開 Web 界面,導航至「設置」->「MCP 服務器」。 - 在該頁面中,你可以直接編輯 JSON 來管理服務器列表。
- 如果在鏈接模式(link mode)下開發,修改代碼後運行
pnpm build並刷新瀏覽器頁面即可,無需重新執行安裝命令。
適用場景與注意¶
- 版本要求:此插件依賴
@deepseek-ai/dsh >= 0.1.7-rc.1。 - 瀏覽器構建:雖然插件自帶
lib/預構建文件,但構建瀏覽器包時需要 DeepSeek Harness 倉庫可用(源碼開發時需注意)。 - 配置權限:插件以當前 DSH 進程的權限運行,請確保源碼安全且許可證符合你的需求。
短結尾¶
通過這個插件,你可以在瀏覽器中完成 MCP 服務器的配置與即時測試,無需離開 Web 界面。更多信息和源碼,請訪問項目主頁。