前言¶
在 DSH(DeepSeek Harness)中接入 MCP(Model Context Protocol)服務時,開發者通常需要手動在各個客戶端(Cursor、Claude Code、VS Code 等)的配置文件中添加條目,然後重啓 DSH。這種方式不僅繁瑣,而且容易在不同來源的配置之間產生衝突。
是什麼¶
dsh-mcp-link 是一個 DSH 插件,提供統一的界面來掃描和接入本機的 MCP 配置。它維護者爲 zdkcomeon,支持從多個客戶端的配置文件中讀取 MCP 服務,並在 DSH 中管理這些服務。
核心功能¶
統一入口:左側導航中的「MCP 鏈接」直接打開主面板;設置 → MCP 鏈接 打開同一份內容。
系統配置掃描:讀取 Cursor、Claude Code、Codex CLI、Gemini CLI、VS Code 等客戶端的 MCP 配置。
來源導航:系統 MCP 按來源顯示爲頂部標籤頁,點擊應用名稱切換,下方只展示當前來源的服務。
已鏈接識別:根據傳輸方式、命令參數或 URL 判斷服務是否已經接入 DSH,並在列表中顯示「已鏈接」。
一鍵接入:把選中的配置寫入當前 profile 的 cordis.patch.yml,由 DSH Loader 加載。
項目 MCP:從 DSH 左側工作區列表多選工作區,掃描項目內的 .mcp.json、.cursor/mcp.json、.vscode/mcp.json 等文件;也支持添加自定義路徑。
新增 MCP:支持粘貼 JSON 導入,或在圖形表單中填寫連接信息。
編輯 MCP:修改服務名、傳輸方式、命令、參數、工作目錄、環境變量、URL、請求頭和工具調用超時。
配置保留:表單未覆蓋的字段會原樣保留;未修改的 !!js 表達式保留原標籤。
移除 MCP:刪除當前 profile patch 中由本插件插入的條目,不修改源配置。
項目變量替換:\({workspaceFolder}、\)、\({projectPath}、\) 會替換爲項目路徑。
安裝與啓用¶
從 npm 安裝:
dsh plugin --profile desktop add dsh-mcp-link
從 Git 安裝:
dsh plugin --profile desktop add github:zdkcomeon/dsh-mcp-link
安裝會把這個包加入 profile 的 dsh.profile.bundles,並在 profile 目錄中建立依賴。新增 bundle 後需要重啓 DSH;只修改 cordis.patch.yml 時,HMR 會熱加載。
環境要求:DeepSeek Harness 0.2.0-rc.2 及以上;Node.js 22.19 及以上。
典型用法¶
打開頁面:點擊左側導航中的「MCP 鏈接」,在主面板中打開;或打開「設置 → MCP 鏈接」。
接入系統 MCP:
1. 在「系統已有 MCP」頂部的來源標籤中選擇 Cursor、Codex CLI、Gemini CLI 等。
2. 找到要接入的服務,點擊「接入 DSH」。
3. 確認 DSH 服務名後點擊「接入」。
4. 接入成功後,服務會出現在「已接入 DSH」,新的 MCP 工具在新會話中可用。
接入項目 MCP:
1. 在「項目 MCP」中點擊「選擇工作區」。
2. 從 DSH 左側工作區列表中勾選一個或多個工作區。
3. 勾選變化後自動重新掃描項目內的 MCP 配置。
4. 下拉底部的「添加自定義路徑」可以掃描未登記爲工作區的目錄。
新增 MCP:點擊「已接入 DSH」右上角的「新增 MCP」,選擇一種方式:
- JSON 導入:支持單個服務對象、只含一個條目的 mcpServers 映射,或 DSH mcp-client 配置。
- 圖形配置:填寫服務名、傳輸方式、命令、啓動參數、工作目錄、環境變量、URL、請求頭和工具調用超時。
編輯與移除:
- 編輯:讀取當前 profile patch 中該條目的配置。非敏感值回填到表單,敏感值不返回瀏覽器,留空表示保留當前值。
- 移除:只刪除當前 profile cordis.patch.yml 中由本插件插入的行。來自 home patch、bundle 或其他配置層的條目會顯示爲不可移除。
適用場景與注意¶
適合已經配置了多個 MCP 客戶端、需要在 DSH 中統一管理這些服務的開發者。插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
短結尾¶
dsh-mcp-link 將分散在各個客戶端配置文件中的 MCP 服務集中管理,通過統一界面實現接入、編輯和移除操作,減少手動配置的繁瑣。相關鏈接:GitHub | 目錄頁