前言¶
如果你在本地維護着一組 MCP(Model Context Protocol)服務器,工具一直都在,但換到 DSH 的 web 環境裏,這些工具默認並不能被模型直接調用。常見做法是手工搬運配置、再寫一遍接入邏輯。dsh-mcp-sync 把這段流程做成了插件:掃描本地 MCP 配置,連接 MCP 服務器,把發現的工具註冊好,供模型直接調用。
下面介紹它的定位、功能與安裝方式。
這是什麼¶
dsh-mcp-sync 是一個 DSH(DeepSeek Harness)插件,維護者是 nan1010082085,許可證爲 MIT。一句話定位:掃描本地 MCP 配置,連接 MCP 服務器並註冊工具供模型直接調用,內置重試邏輯與統計。
一個背景信息:該 GitHub 倉庫的 README 目前以 dsh-plugins monorepo 的形式組織,裏面包含 chat-sync、ima-sync、mcp-sync 三個插件包,mcp-sync 是其中之一;倉庫本身與 package.json 裏聲明的 dsh-mcp-sync 對應。
核心功能¶
按 README 與 package.json 的描述,插件做四件事:
1、掃描本地 MCP 配置;
2、連接 MCP 服務器,發現工具;
3、註冊工具,供模型直接調用;
4、內置重試邏輯與統計。
幾個技術細節:
- 運行時依賴
@modelcontextprotocol/sdk^1.0.0 和@deepseek-ai/schemastery^3.18.0; - package.json 聲明
dsh.client.platform爲web,客戶端側注入@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-settings; - 關鍵詞包含 claude-code、codex、cursor、model-context-protocol、mcp-client、tool-registration。
安裝與啓用¶
安裝命令統一帶 --profile web,與包內聲明的 web 平臺對應。三種方式如下:
# GitHub 安裝(推薦,獨立倉庫,版本同步)
dsh plugin --profile web add github:nan1010082085/dsh-mcp-sync
# npm 安裝
dsh plugin --profile web add dsh-mcp-sync
# 本地 link 安裝(改源碼重啓 dsh web 即生效)
dsh plugin --profile web add link:$(pwd)/packages/mcp-sync
第一行從 GitHub 獨立倉庫安裝,README 推薦這種方式,版本隨發佈同步;第二行走 npm;第三行用於調試,前提是本地已檢出 dsh-plugins monorepo,鏈接其中的 packages/mcp-sync 目錄,改完源碼重啓 dsh web 即可生效。經過上面的步驟,插件就裝進 web profile 了。
開發與發佈¶
這部分面向想改代碼或參與維護的人。改完源碼可以先做語法檢查:
node --check packages/mcp-sync/lib/*.js
monorepo 下每個包獨立版本發佈:進入 packages/<plugin> 執行 npm publish;發佈後必須執行 ./scripts/sync-repos.sh 把包同步到獨立 GitHub 倉庫,支持全部同步或按包名同步(如 ./scripts/sync-repos.sh ima-sync)。普通用戶安裝插件時不涉及這些步驟。
適用場景與注意¶
適合誰:本地已經有 MCP 配置和服務器,希望這些工具在 DSH 的 web profile 裏直接可用、不想重複寫接入代碼的開發者。
使用前注意:
1、插件以當前 dsh 進程的權限運行,會掃描本地配置、連接 MCP 服務器。安裝前建議先讀一遍源碼,確認行爲符合預期;許可證爲 MIT,各包同源。
2、安裝命令帶 --profile web,包聲明 dsh.client.platform 爲 web,面向 web profile 使用。
3、版本號方面,截至本文寫作時(2026-09-07),抓取到的資料裏 README 包表格爲 0.7.0、package.json 爲 0.7.1,兩處不一致,以倉庫實際發佈爲準。
小結¶
dsh-mcp-sync 解決的是一個具體問題:把「本地 MCP 工具」變成「DSH 裏模型可直接調用的工具」,掃描、連接、註冊一步完成,附帶重試與統計。如果你已經有現成的 MCP 環境,裝上即可複用。
- GitHub 倉庫:https://github.com/nan1010082085/dsh-mcp-sync
- 社區插件目錄收錄頁:https://www.skillhub.cn/plugins/nan1010082085/dsh-mcp-sync(社區站點,獨立運營,與 DeepSeek / 幻方無官方從屬關係)