前言¶

DeepSeek Harness（DSH）通過 @deepseek-ai/dsh-mcp-client 接入 MCP 服務器，配置通常寫在 profile 的 cordis.patch.yml 裏。條目一多，要確認「裝沒裝、連沒連、啓沒啓」往往得翻 YAML、重啓或靠日誌排查，改錯還容易影響正在運行的連接。

dsh-mcp-manager（npm 包名 @js2hou/dsh-mcp-manager）由社區維護者 Js2Hou 發佈，在 Web 界面的 設置 → MCP 提供 MCP 服務器的列表、增刪、啓用/停用與連接狀態查看，修改經 HMR 寫回補丁文件，無需手改 YAML。插件歸類爲客戶端，MIT 許可；截至 2026-08-27，GitHub 約 11 stars。

這是什麼¶

一句話：面向 DSH Web profile 的 MCP 可視化管理插件。

它在瀏覽器端註冊 設置 → MCP 頁籤，通過僅限 loopback 的 Connection RPC（/mcp-manager）與宿主通信；瀏覽器不直接讀寫文件系統，所有持久化由宿主寫入 profile 的 cordis.patch.yml。與純手改配置相比，同一套數據多了即時狀態、格式校驗和連接探測。

核心功能¶

下面按 README 已列能力歸納，均可在安裝後於 設置 → MCP 驗證。

服務器列表：遍歷 profile 中已安裝的 @deepseek-ai/dsh-mcp-client 實例，展示 serverName、傳輸方式（stdio / streamable-http）、URL 或命令、啓用狀態、加載階段、已註冊工具數。

新增與刪除：表單添加 MCP 服務器，支持 stdio 與 streamable-http；可配置 env、headers、args、超時、failOnStartupError 等字段，並對格式與重名做校驗。刪除爲一鍵操作。

啓用與停用：隨時切換單臺服務器；工具隨啓用狀態熱連接或熱斷開。

連接狀態與測試：每臺服務器顯示狀態膠囊（如 Connected · N tools、Failed、Loading、Disabled）。獨立 Test 按鈕執行 initialize + tools/list 探測，報告延遲與工具數。

編輯：在卡片原位展開表單，保存即應用。

多語言：界面文案跟隨 DSH 語言設置（zh / en）。

持久化：變更寫入 profile 的 cordis.patch.yml，重啓後保留；頁面底部顯示當前補丁文件路徑。

安裝與啓用¶

前置：本機已安裝 DSH，且 dsh web 能正常運行（會初始化 ~/.dsh/profiles/web）。

推薦：dsh 命令安裝

dsh plugin --profile web add @js2hou/dsh-mcp-manager

也可從 GitHub 源安裝（倉庫已包含構建產物 lib/，無需本地構建）：

dsh plugin --profile web add github:Js2Hou/dsh-mcp-manager

插件市場：插件已收錄 dsh-market 與 dsh-plugin-marketplace，可搜索 js2hou/dsh-mcp-manager 安裝；使用 DSH Desktop 時，可在內置市場中通過 DSH 1024Store 或 dshfind 源搜索同名插件，認準作者 Js2Hou。

一鍵腳本（macOS / Linux）：

curl -fsSL https://raw.githubusercontent.com/Js2Hou/dsh-mcp-manager/main/scripts/install.sh | bash

裝完後對瀏覽器做硬刷新（Cmd/Ctrl+Shift+R），打開 設置 → MCP。若頁籤未出現，重啓一次 DSH（host 側首次掛載可能需要）。

更新：再次執行 dsh plugin --profile web add @js2hou/dsh-mcp-manager，或重跑安裝腳本。

典型用法¶

打開 設置 → MCP 後，按 README 說明操作即可。

添加 stdio 服務器：填寫條目 ID、serverName，傳輸方式選 stdio，再填 command、args、env、cwd 等。streamable-http 則填 URL 及所需 headers。

日常運維：在列表中查看每臺服務器的即時狀態與工具數；需要確認連通性時點 Test；臨時不用某臺可 停用，不必刪配置；改參數用 編輯，保存後等待 HMR 應用（通常 1–2 秒，也可點頁面右上角手動刷新）。

可選配置：loader 行支持 patchFile 字段，指定要編輯的用戶補丁層絕對路徑；默認 $DSH_HOME/profiles/web/cordis.patch.yml。

適用場景與注意¶

適合誰：在 DSH 裏維護多臺 MCP、需要一眼看清連接狀態、或不想頻繁手改 cordis.patch.yml 的開發者與智能體配置者。

權限與安全：插件以當前 DSH 進程權限運行，會讀寫 profile 補丁並觸發 MCP 客戶端連接。安裝前建議查看 源碼 與 MIT 許可證，確認配置內容（尤其 env、headers）不含不應暴露的密鑰。

常見問題（摘自 README）：若出現兩個 MCP 頁籤，檢查 cordis.patch.yml 是否殘留舊的手動掛載行；新版本報 minimum release age 時可等 24 小時，或按 README 在 pnpm-workspace.yaml 中爲 @js2hou/dsh-mcp-manager 配置 minimumReleaseAgeExclude；Obsidian 等需 Bearer 認證的 MCP，headers 應爲 Authorization: Bearer <api-key>，不要多餘引號。

社區插件目錄 SkillHub 與上述市場爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係。

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/Js2Hou/dsh-mcp-manager
• 源碼與文檔：https://github.com/Js2Hou/dsh-mcp-manager
• npm：@js2hou/dsh-mcp-manager（當前 README 對應版本 0.1.5）