DeepSeek Harness (DSH) 採用“一切皆插件”的架構。在管理 MCP 服務器實例時，傳統的配置方式通常需要手動編輯配置文件或依賴 patch 配置，操作不夠直觀。dsh-mcp-manager 是一個針對 DSH 的 MCP 管理插件，它通過 Web GUI 提供了啓停 mcp-client 實例的能力，並支持從本機配置文件中自動發現並導入 MCP 服務器。
該插件由 welsione 維護，開源協議爲 MIT。
核心功能¶
-
Web GUI 設置面板
在 DSH 的設置頁會出現“MCP 管理”入口。該面板列出了所有已掛載的mcp-client實例，支持通過搜索和篩選（全部/已啓用/已停用）快速定位，並支持一鍵開關。 -
真啓停
與簡單的開關不同，該插件提供的啓停是“真啓停”。停用服務器會斷開連接並註銷其工具（mcp__<server>__*），這些工具對 Agent 運行時將不可見；啓用則會重新連接並註冊工具。 -
自動掛載
插件支持從<harness home>/mcp-servers.json讀取服務器配置。只要在此文件中聲明服務器，插件在啓動時就會自動掛載爲mcp-client實例。 -
本機配置源發現
面板底部提供“本機配置源發現”功能，可掃描 Claude Code 全局配置（~/.claude.json）、項目配置（~/.mcp.json）以及 Claude Desktop 的配置。它能探測本地地址的運行狀態，並支持一鍵導入。 -
批量操作
提供工具欄“全部啓用”和“全部停用”功能，支持對多個服務器進行批量管理。 -
持久化與 Headless 兼容
服務的禁用名單會持久化存儲在<harness home>/mcp-manager.json中，重啓後自動重新應用。同時，插件兼容 Headless 模式，即使沒有 Web GUI 也能通過底層邏輯正常啓停。 -
零構建
插件採用單文件結構（ESM host + ModuleLoader client），無需編譯步驟即可直接使用。
安裝與啓用¶
使用該插件需要 DSH 版本 0.1.0-rc.7 及以上。安裝過程如下：
- 通過命令行安裝插件包。
# 方式一：從 npm 發佈源安裝
dsh plugin --profile web add dsh-mcp-manager
# 方式二：從 GitHub 直接安裝（需確保代碼已提交）
dsh plugin --profile web add github:welsione/dsh-mcp-manager
# 方式三：固定版本安裝（推薦，避免 main 分支漂移）
dsh plugin --profile web add github:welsione/dsh-mcp-manager#v1.0.0
- 安裝完成後，重啓 DSH 進程。插件會自動進入
dsh.profile.bundles，並在 Web 界面的設置頁加載管理面板。
使用方法¶
1. 自動掛載（推薦）¶
在 <harness home>/mcp-servers.json 中聲明服務器。該插件兼容 Claude 的 mcpServers 風格配置。
{
"servers": {
"filesystem": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}
聲明後，刷新頁面或在面板點擊“重新掃描”，新服務器會自動掛載。
2. Patch 實例掛載¶
如果需要更細粒度的控制，也可以在 profile 的 cordis.patch.yml 中添加 @deepseek-ai/dsh-mcp-client。
- insert:
- id: mcp-my-server
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: my-server
transport: stdio
command: npx
args: ['-y', '@some/mcp-server']
3. 導入本機配置¶
在“MCP 管理”面板底部的“本機配置源發現”區域，系統會列出本機已配置的 MCP 服務器。對於支持掛載的條目（如 stdio 或 streamable-http），點擊“導入”即可將其寫入 mcp-servers.json 並立即生效。
4. 熱更新¶
對配置文件進行修改後，無需重啓 DSH，直接在 Web 面板點擊“重新掃描”即可實現增刪和熱更新。
注意事項¶
- SSE 協議限制：如果本機配置源中發現的是 SSE 協議的服務器（如 JetBrains IDEA 或 DataGrip 的 MCP 插件），界面會提示“暫不支持掛載”。這是因爲 DSH 官方的
dsh-mcp-client目前僅支持stdio和streamable-http傳輸協議。 - 配置項隱藏：配置源發現 API 在展示配置時，不會返回配置文件中的
env或headers值，只顯示是否存在。 - GitHub 安裝機制：使用
github:前綴安裝時，獲取的是 GitHub 上已提交的代碼。如果本地修改了代碼但未git push，則無法通過該方式安裝。
總結¶
dsh-mcp-manager 解決了在 DSH 中管理多個 MCP 實例的繁瑣問題。通過 Web 界面實現了可視化的啓停、批量操作以及配置發現，配合自動掛載和持久化機制，能夠顯著提升開發與調試效率。
- 倉庫地址：https://github.com/welsione/dsh-mcp-manager
- 收錄目錄：https://www.skillhub.cn/plugins/welsione/dsh-mcp-manager
