前言¶
在 DeepSeek Harness(DSH)裏做智能體擴展時,常見痛點不只是“能不能調用 MCP”,而是 MCP Server 來源分散:不同廠商的端點、不同鑑權方式、不同 stdio/HTTP 運行方式,往往都要手工配置成 mcpServers JSON。配置完成後,還要繼續處理 OAuth 登錄、API Key、工具與 Prompt 發現、連接斷開和重啓恢復。
dsh-mcp-connector 是一個 DSH 插件,定位是 DeepSeek Harness 的 MCP 連接器與 MCP Server 市場,用於統一發現、授權和連接管理。DSH 的插件生態可以理解爲「一切皆插件」;這裏的 MCP Server 市場是獨立社區目錄,不是 DeepSeek / 幻方的官方應用商店。
這是什麼¶
倉庫爲 duhu2000/dsh-mcp-connector,許可證爲 MIT。GitHub owner 爲 duhu2000;倉庫內 README/package.json 中的維護者表述爲企查查/QCC。
當前公開版本爲 dsh-mcp-connector@0.2.32,對應 GitHub Release v0.2.32。
這個插件把 MCP Server 的接入從“一次性手工配置”變成可瀏覽、可授權、可管理、可更新的市場目錄。它不會僞裝成獨立 DSH Skill;能力主要來自 MCP 工具和 Prompt。
核心功能¶
- 統一發現、授權和連接管理。
- 支持 OAuth 2.0 PKCE、API Key、stdio/HTTP、
mcpServersJSON 導入。 - 支持工具與 Prompt 發現。
- 提供持續更新的精選連接器目錄、圖形化市場、圖形化添加與連接器詳情。
- Prompt 模板支持
{{company}}等變量,發送前填寫真實查詢主體。 - 連接生命週期管理:連接持久化、重啓恢復、啓停、斷開、OAuth 自動刷新/退避恢復與撤銷。
- 獨立遠程 Registry;遠程不可用時自動回退內置目錄。
- 插件版本檢測與安全更新。
- 平滑遷移:顯式掃描並複製兩個舊企查查 OAuth 插件授權。
- 對話工具包括:
mcp_connector_catalog、connect、configure、import_json、install_from_url、status、health_check、set_enabled、disconnect、refresh_catalog、publish、tools_list
安裝與啓用¶
要求:DeepSeek Harness Desktop/web profile,Node.js 20 或更高版本。
先執行安裝命令:
dsh plugin --profile web add dsh-mcp-connector
重複執行安裝命令即可升級。也可以使用安裝腳本:
bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
安裝或升級後,完全重啓 DeepSeek Harness Desktop 或 dsh web。如果使用 dsh web,需要先停止原進程再啓動;出現 EADDRINUSE 127.0.0.1:3080 表示已有實例正在運行。
重啓後打開左側「MCP連接器」入口。
典型用法¶
1、在市場中選擇連接器,並完成授權或配置。
2、打開卡片詳情,查看工具與 Prompt。
3、如果詳情裏有示例 Prompt,可點擊發送按鈕,在當前工作區創建/複用空白會話並寫入草稿。
4、在“已安裝”或對話工具中查看、停用、恢復或斷開連接。
連接成功後,工具會按以下前綴提供給模型:
mcp__<serverName>__*
如果要導入已有配置,可使用 mcpServers JSON 導入;如果要通過 URL 安裝,可使用 install_from_url 或圖形化添加入口。
目錄與配置¶
獨立遠程 Registry 可單獨更新,市場卡片在客戶端刷新後可見。截至 2026-09-01,公共 Registry 已發佈 97 條連接器描述;與隨包的 4 張企查查卡片合併去重後,市場頁可瀏覽 101 張卡片。推薦位嚴格保留 4 張企查查卡片、北大法寶和 Wind,共 6 張;其他連接器按業務分類展示。
Bundle 默認配置位於 cordis.patch.yml:
- id: mcp-connector
name: dsh-mcp-connector
config:
catalogUrl: 'https://cdn.jsdelivr.net/gh/duhu2000/dsh-mcp-connector-registry@main/catalog.json'
persistSecrets: true
entryPrefix: mcp
refreshSkewMs: 300000
openBrowser: true
catalogUrl 默認通過 jsDelivr CDN 讀取公共 registry。由於 jsDelivr 的分支 URL 可能存在緩存延遲,Registry 合併後的新卡片不保證秒級出現。需要離線/私有模式時,可將 catalogUrl 顯式設爲空字符串。
適用場景與注意¶
適合已經在 DSH Desktop/web 中使用 MCP,且希望減少手工配置、統一查看連接狀態的開發者。
插件會以當前 dsh / DeepSeek Harness 進程的權限運行,因此安裝前應檢查源碼、發佈來源和 MIT 許可證。連接外部 MCP Server 時,授權信息會用於實際調用;使用 API Key、OAuth 或 stdio 命令前,確認對應服務與命令是可信的。
版本發佈方面,Release 通過 npm Trusted Publishing (GitHub OIDC) 發佈,不依賴長期 NPM_TOKEN。
結尾¶
dsh-mcp-connector 的價值在於把 MCP Server 的發現、授權、連接管理和 Prompt 工具發現放進同一個 DSH 插件裏。安裝或升級後,從左側「MCP連接器」進入;GitHub 倉庫地址爲:
https://github.com/duhu2000/dsh-mcp-connector