前言¶
在 DSH（DeepSeek Harness）裏維護 MCP 服務器時，常見問題不只是“有沒有連上”，還有工具數是否正常、不同 profile 的狀態是否一致。只看單個 profile，或手動翻配置，容易漏掉未連接的服務器。
dsh-mcp-admin 是一個 DSH 插件，用來查看 MCP 狀態，並在設置頁裏按 profile 管理 MCP 服務器。
這是什麼¶
dsh-mcp-admin 由 kairoz9 維護，採用 MIT 許可。
它提供兩個入口：
- /mcp 命令：列出 MCP 服務器和即時工具數。
- 設置頁 MCP 面板：按 profile 管理 MCP 服務器。
保存操作會寫回該 profile 的 cordis.patch.yml，隨後觸發 dsh 的熱加載（HMR）。
核心功能¶
/mcp 命令¶
運行 /mcp 後，可以列出所有 profile 的 MCP 服務器，並看到即時工具數。列表包括從未連接的服務器。
設置頁 MCP 面板¶
設置頁的 MCP 面板支持按 profile 管理 MCP 服務器：
- 新增
- 編輯
- 禁用
- 啓用
- 刪除
狀態點每秒自動刷新。保存後，配置會寫回該 profile 的 cordis.patch.yml，dsh 會自動執行 HMR。
安裝與啓用¶
下面命令將插件安裝到 web profile：
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin
README 建議固定到 commit 或 tag，例如：
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin#v0.2.0
如果使用 pnpm >=10 從 Git 安裝失敗，需要注意：pnpm >=10 默認會拒絕運行 Git 依賴的 prepare 腳本，這可能導致首次 Git 安裝失敗。可以在該 profile 的 pnpm-workspace.yaml 中加入：
allowBuilds:
dsh-mcp-admin: true
然後重新運行 add 命令。
典型用法¶
1、查看 MCP 狀態
運行：
/mcp
命令會列出所有 profile 的 MCP 服務器，並顯示即時工具數。從未連接的服務器也會出現在列表中。
2、管理某個 profile 的 MCP 服務器
進入設置頁的 MCP 面板，選擇目標 profile，然後執行新增、編輯、禁用、啓用或刪除。
3、保存並生效
保存會寫回該 profile 的 cordis.patch.yml。dsh 隨後會自動熱加載（HMR）。
適用場景與注意¶
適合在多個 DSH profile 中維護 MCP 服務器，希望直接查看狀態並調整配置的使用者。
注意：
- 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與 MIT 許可證。
- 保存會寫回 cordis.patch.yml，屬於 profile 配置變更。
- pnpm >=10 下從 Git 安裝可能失敗，需要添加 allowBuilds 後重試。
結尾¶
dsh-mcp-admin 將 /mcp 狀態查看和設置頁 MCP 管理結合在一起，適合需要經常調整 MCP 服務器配置、並希望在 DSH 內直接完成查看與保存的開發者。
