dsh-mcp-sync:掃描本地 MCP 配置,把工具註冊給模型直接調用

前言

如果你在本地維護着一組 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 / 幻方無官方從屬關係)
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜