前言¶

DSH 的理念是「一切皆插件」，插件通常用於擴展 DeepSeek Harness 的能力。對於只通過 MCP 與外部系統協作的 Agent 來說，直接搜索、檢查、安裝並運行 DSH 插件會缺少一層標準接口。

下面介紹 bobleer/deepseek-harness-plugin-mcp。它是一個 MIT 許可的 MCP server，目標是讓任意 Agent 可以發現、檢查、安裝並運行 DeepSeek Harness 插件。

這是什麼¶

deepseek-harness-plugin-mcp 是一個 MCP server，倉庫地址爲 bobleer/deepseek-harness-plugin-mcp。已覈實資料中的維護者信息存在不一致：倉庫線索指向 bobleer，README 寫 Made by BitFun，因此本文不把二者寫成確定關係。

它把 DSH 插件能力拆成三個平面：

• Catalog：發現、列出、檢查公開 dsh-plugin 倉庫，並讀取 README 與 cordis.patch.yml。
• Profile：在 dsh 位於 PATH 且開啓 --allow-install 時，對真實 profile 執行 dsh plugin add / remove。
• Runtime：在 dsh 位於 PATH 且開啓 --allow-runtime 時，啓動 profile，並把 DSH 工具暴露爲 dsh__*。

它提供 dsh_plugin_* 與 dsh_runtime_* 兩類 MCP 工具，同時暴露 dsh-plugin:// 資源以及 search-dsh-plugins、install-dsh-plugin、use-dsh-plugin 提示。

默認情況下，Catalog 平面始終可用；Profile 與 Runtime 平面在開啓前保持關閉。

核心功能¶

Catalog¶

Catalog 用於讓 Agent 先了解可安裝對象。它可以搜索、列出、檢查公開 dsh-plugin 倉庫，並讀取倉庫中的 README 與 cordis.patch.yml。

這一步不要求本機安裝 dsh，也不執行插件代碼。

Profile¶

Profile 用於把插件加入真實的 DSH profile。當 dsh 位於 PATH，並且服務端開啓 --allow-install 時，Agent 可以執行 dsh plugin add / remove。

這一步會改變本機 profile 中的插件列表，屬於安裝類操作。

Runtime¶

Runtime 用於啓動一個 profile，並把其中暴露出來的 DSH 工具橋接爲 MCP 工具。當 dsh 位於 PATH，並且服務端開啓 --allow-runtime 時，Agent 可以通過 dsh_runtime_* 啓動、停止和加載 profile，然後調用形如 dsh__* 的工具。

Runtime 路徑會 spawn DSH 並運行插件代碼，因此安裝和啓用前應先檢查插件源碼與許可證。

UI/TUI/skin 插件¶

UI、TUI、skin 類型插件可以被目錄化，也可以安裝，但它們不會變成 MCP 工具。這類插件的界面仍然留在 DSH 中。

安裝與啓用¶

基礎安裝¶

先安裝全局命令。已覈實安裝命令如下：

npm install -g deepseek-harness-plugin-mcp

也可以直接查看幫助：

npx deepseek-harness-plugin-mcp --help

Node 引擎要求爲：

^22.19.0 || >=24.0.0

stdio 接入¶

先做 stdio 接入，命令如下：

npx -y deepseek-harness-plugin-mcp

如果需要用 GitHub API 認證，可以設置可選環境變量：

GITHUB_TOKEN

GITHUB_TOKEN / GH_TOKEN 是可選配置，但建議配置。

開啓 Profile 與 Runtime¶

如果 Agent 需要安裝插件或啓動 Runtime，先確認 dsh 在 PATH 中，再啓動：

npx -y deepseek-harness-plugin-mcp --allow-install --allow-runtime

同時設置目標 profile：

DSH_PLUGIN_MCP_PROFILE

這裏會執行 dsh plugin 相關動作，並在 Runtime 路徑下 spawn DSH、運行插件代碼。建議將其視爲權限敏感操作，在啓用前檢查插件源碼與許可證。

Streamable HTTP¶

使用 HTTP 方式時，先啓動服務：

dsh-plugin-mcp --http --port 8765 --allow-runtime

然後讓 Agent 指向：

http://127.0.0.1:8765/mcp

在 DSH 內使用¶

這個包本身可以作爲 DSH bundle 加入 profile。下面示例使用 web profile：

dsh plugin --profile web add github:bobleer/deepseek-harness-plugin-mcp
dsh --profile web

經過上面的步驟，DSH 會加載該 bundle。具體可用工具仍以啓動後的 DSH 與插件註冊結果爲準。

典型用法¶

Agent 通常可以按下面順序工作：

1. 用 dsh_plugin_search 按任務關鍵詞搜索插件。
2. 用 dsh_plugin_inspect 檢查候選插件的 owner/repo。
3. 如需要，用 dsh_plugin_install 安裝插件。
4. 用 dsh_runtime_start 啓動 profile。
5. 調用暴露出來的 dsh__* 工具。

這裏的安裝和 Runtime 步驟都依賴本地 dsh 可用，並且需要服務端開啓對應開關。

適用場景與注意¶

• 適合需要讓 Agent 發現、檢查、安裝或運行 DSH 插件的開發者。
• Catalog 平面默認可用；Profile 與 Runtime 平面默認關閉，需要顯式開啓。
• Profile 與 Runtime 平面要求 dsh 位於 PATH。
• GITHUB_TOKEN / GH_TOKEN 可選，但建議配置，用於 GitHub API 認證。
• UI/TUI/skin 插件可以目錄化和安裝，但不會變成 MCP 工具，界面仍保留在 DSH 中。
• Runtime 路徑會 spawn DSH 並運行插件代碼。安裝插件前，應先檢查源碼與許可證。
• Node 引擎要求爲 ^22.19.0 || >=24.0.0。
• 該項目採用 MIT 許可。
• 它面向公開 dsh-plugin 倉庫，不應被寫成 DeepSeek 官方應用商店，也不代表 DeepSeek / 幻方與該目錄存在官方從屬關係。
• 已覈實資料未給出可確認的目錄頁 URL，因此本文不列出目錄頁地址。

結尾¶

bobleer/deepseek-harness-plugin-mcp 的價值在於把 DSH 插件的發現、檢查和運行能力接入 MCP，讓 Agent 可以用統一接口處理插件。它默認保持保守：Catalog 可用，安裝與運行需要顯式開啓，並且本地必須存在可用的 dsh。

GitHub：

https://github.com/bobleer/deepseek-harness-plugin-mcp