前言¶
在 DSH 中接入多個 MCP 服務器後，常見問題是：某臺服務器是否已配置、當前是啓用還是停用、loader 是否正在加載、已經註冊了多少工具；Skills 也需要在多個來源中查找和切換狀態。這個插件將這類操作放到 DSH 設置頁中，用一頁查看 MCP 服務器列表與連接狀態，並支持新增、刪除、啓用、停用、重啓和 JSON 導入導出，同時提供 設置 → Skills 管理 與 HTTP API。
這是什麼¶
@xxxyz/dsh-mcp-manager 是 xxxyz 維護的 DeepSeek Harness 插件，許可證爲 MIT。它把 MCP 服務器配置寫到項目級或全局的 cordis.patch.yml，並在 DSH Web 設置中提供管理入口。下面介紹它的功能、安裝方式和典型用法。
核心功能¶
- MCP 服務器列表：展示
serverName、傳輸方式、URL/命令、啓用狀態、loader 即時加載階段、已註冊工具數。 - 新增 / 刪除 MCP 服務器：支持
env、headers、args，帶格式與重名校驗。 - 啓用 / 停用 MCP 服務器：工具隨之熱連接 / 熱斷開。
- 重啓 MCP 服務器：執行 disable + re-enable，自動重連並重新同步工具。
- 配置持久化：寫入項目級
profiles/<profile>/cordis.patch.yml或全局~/.dsh/cordis.patch.yml，重啓後保留。 - 健康檢查：顯示每臺服務器的即時工具數與 loader 階段。
- JSON 導出 / 導入：合併新增，已存在自動跳過。
- 宿主註冊 4 個
mcp_manager_*模型工具。 - 設置 → Skills 管理：瀏覽 / 搜索技能，按來源分組，按 provider 摺疊，一鍵啓用或停用任意技能。
- HTTP API：
POST /dsh-mcp-manager/api，請求體爲{op, args}，返回{ok, ...}。 - 一條命令安裝並自動掛載，支持 Windows / macOS / Linux。
安裝與啓用¶
前置條件：已安裝 DSH 且 dsh web 能正常運行；Node.js ≥ 18、pnpm ≥ 9。
執行安裝命令：
dsh plugin --profile web add @xxxyz/dsh-mcp-manager@latest
這條命令會安裝插件並自動掛載。裝完後在瀏覽器中硬刷新（Cmd/Ctrl+Shift+R），即可看到 設置 → MCP 管理。
如果 npm view 報 404，可能是鏡像同步延遲。可以稍等再試，或使用：
--registry=https://registry.npmjs.org
典型用法¶
1、打開 設置 → MCP 管理，填寫 serverName、傳輸方式及對應字段，並選擇項目級或全局。
2、在 MCP 管理卡片上啓用 / 停用、重啓、編輯、刪除服務器。
3、一鍵導出 JSON，或粘貼 JSON 導入；導入會合並新增，已存在的服務器自動跳過。
4、打開 設置 → Skills 管理，瀏覽 / 搜索技能，並一鍵啓用 / 停用任意技能。
5、通過腳本調用 HTTP API：
POST /dsh-mcp-manager/api
請求體中的 op 爲操作名，args 爲參數對象：
{
"op": "operation",
"args": {}
}
響應：
{
"ok": true
}
6、卸載插件：
dsh plugin --profile web remove @xxxyz/dsh-mcp-manager
執行後重啓 DSH。
配置與安全¶
修改配置走 HMR 熱應用，通常等 1–2 秒自動刷新；頁面會自動輪詢。
loader 行必須爲 insert 塊形式。通常無需手動寫，dsh plugin add 的 bundle patch 會自動插入。
token 是可選訪問令牌，默認關閉。設置後，寫操作需要攜帶：
x-dsh-token: <token>
也可以通過環境變量配置：
DSH_MCP_MANAGER_TOKEN=<token>
如果將 3080 端口暴露到局域網/公網，token 是防止任意寫操作與 stdio command 注入的重要防線；本地單機使用不需要配置。
HTTP API 帶 CSRF 防護：僅接受 POST，必須攜帶：
x-dsh-plugin: dsh-mcp-manager
並校驗同源 Origin；curl 等本地腳本無需 Origin。
如果頁面出現兩個 MCP 頁籤或工具重複，需要刪除舊 loader 行或 dsh.profile.bundles 條目，然後重啓 DSH。
適用場景與注意¶
這個插件適合需要在 DSH 中集中查看 MCP 服務器狀態、管理服務器配置、切換技能狀態，或者通過腳本 / HTTP API 操作 MCP 管理的開發者。
因爲插件會管理 MCP 服務器配置，stdio 類型服務器可能執行本地命令，並且插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。該插件許可證爲 MIT。
