前言¶
在 DeepSeek Harness（DSH）中，MCP（Model Context Protocol）服務的接入通常涉及手動維護配置文件。dsh-plug-mcp 插件提供了一個 Web 界面，解決了在 Web UI 的「設置 → 插件 → MCP」標籤頁中發現 GitHub 上的 MCP 服務倉庫、查看詳情以及一鍵安裝或移除的需求。
插件介紹¶
dsh-plug-mcp 是由 Casually 開發的 DeepSeek Harness 插件，定位爲 MCP 服務管理器。它通過 Web UI 與 GitHub 註冊表交互，允許用戶按 Topic 搜索倉庫，自動探測發佈狀態和啓動線索，並將服務配置寫入 DSH 的 home 層。
核心功能¶
-
倉庫發現與搜索
支持按 GitHub topic（如mcp-server、modelcontextprotocol）搜索倉庫。用戶可追加關鍵詞，並按最多 Star 或最近更新排序，支持翻頁。 -
詳情查看
點擊倉庫可查看詳情彈窗，內容包括星標數、Topics、許可證、README 以及內容探測結果。探測會檢查package.json（npm 狀態）、pyproject.toml（PyPI 狀態）以及 README 中的npx、uvx、docker run等啓動線索，自動填充安裝表單。 -
一鍵安裝與移除
確認信息後點擊安裝，插件會在$DSH_HOME/cordis.patch.yml（home 層，作用於所有 profile）中追加@deepseek-ai/dsh-mcp-client配置行。
安裝後，DSH 會監視該文件的 HMR（熱重載）變化，通常無需重啓即可生效。移除功能支持在已安裝列表中一鍵刪除配置。 -
代理配置
發現功能默認直連 GitHub。當網絡受限時，可在 Web UI 的「GitHub 代理」欄配置代理。配置來源按優先級生效：UI 持久設置、profile 的cordis.patch.yml中的config.proxy、以及環境變量DSH_PLUG_MCP_PROXY。支持http、https、socks5等協議。 -
本地 API
插件提供本地 JSON API（僅監聽迴環地址），包括/plug-mcp/search、/plug-mcp/repo、/plug-mcp/local、/plug-mcp/install、/plug-mcp/remove、/plug-mcp/proxy和/plug-mcp/proxy-test。
安裝與啓用¶
使用 DSH 官方插件命令安裝。安裝後需重啓 DSH 以組合新 bundle，此時「MCP」標籤頁將出現在設置 → 插件 下。
# 推薦使用 npm 安裝
dsh plugin --profile web add -w dsh-plug-mcp
使用說明¶
- 在 Web UI 中進入「設置 → 插件 → MCP」。
- 在發現頁輸入關鍵詞進行搜索。
- 如需訪問受限的 GitHub，點擊「GitHub 代理」欄配置代理並測試連接。
- 點擊倉庫查看詳情，確認啓動命令後點擊「安裝」。
- 在「已安裝」頁可查看當前註冊的所有 MCP 服務，並執行移除操作。
注意事項¶
- 依賴要求：宿主環境需安裝
curl（用於代理請求）和pnpm（用於dsh plugin命令）。 - 代碼運行環境：MCP 服務以標準
@deepseek-ai/dsh-mcp-client行登記。每條 MCP 服務命令都是沙箱外的受信可執行代碼，等同於在 shell 中運行npx -y …。請僅安裝可信源碼的服務。 - 配置文件：所有安裝與移除操作直接修改
$DSH_HOME/cordis.patch.yml。插件會在修改前備份文件（保留最近 10 份），並校驗寫入後的 YAML 可讀性，避免寫入損壞的配置。 - 技術棧：插件僅依賴
js-yaml。
總結¶
dsh-plug-mcp 爲 DeepSeek Harness 用戶提供了可視化的 MCP 服務管理能力。通過 GitHub 探測和本地配置管理，它簡化了服務接入流程，支持熱重載和代理配置，適合需要在 DSH 中快速集成和調試 MCP 服務的場景。
