前言¶

如果你在本地维护着一组 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 / 幻方无官方从属关系）