dsh-mcp-sync

dsh-mcp-sync

DSH（DeepSeek Harness）插件：连接 MCP 服务器、发现工具并注册到 DSH 工具系统，让模型可以直接调用 MCP 工具。

v0.7.0 新特性：

• ✨ 自动重试机制：连接失败时自动重试（最多3次）
• 📊 统计信息跟踪：连接成功率、工具调用统计
• 🏥 健康检查端点：实时监控插件状态
• 🔄 重新连接功能：一键重连失败的服务器

功能

能力	说明
MCP 连接	通过 stdio/SSE/StreamableHTTP 连接到 MCP 服务器
工具发现	自动调用 tools/list 发现每个 MCP 服务器的工具
工具注册	将 MCP 工具注册到 DSH 工具系统（命名: mcp____）
元工具	mcp_call 动态调用 + mcp_list_tools 工具发现
多源扫描	Claude Code、Codex CLI、Cursor Agent、DSH 配置
智能去重	按 command + args 或 url 去重
自定义 MCP	支持添加自定义 MCP 服务
连接管理	侧边栏管理面板：连接状态、工具列表、一键刷新
自动重试	连接失败时自动重试（最多3次，可配置）
统计信息	连接成功率、工具调用统计、运行时间
健康检查	/health 端点实时监控插件状态
重新连接	/reconnect 端点一键重连失败的服务器

工作原理

• 扫描: 从 Claude Code / Codex / Cursor / DSH 配置文件读取 MCP 服务器定义
• 连接: 使用 MCP SDK（stdio/SSE/HTTP transport）连接到每个服务器
• 发现: 调用 tools/list 获取每个服务器暴露的工具列表
• 注册: 将每个 MCP 工具注册为 DSH 工具，模型可直接调用

安装

# 从 GitHub 安装（独立仓库，已发布 npm）
dsh plugin --profile web add github:nan1010082085/dsh-mcp-sync

# 或从 npm 安装
dsh plugin --profile web add dsh-mcp-sync

# 重启 dsh web 生效

依赖

• dsh-better-sidebar — 侧边栏标签页系统
• @modelcontextprotocol/sdk — MCP 协议客户端

配置

默认零配置可用。需要调整时，在 profile 的 cordis.patch.yml 按 id 覆盖：

- id: mcp-sync
  config:
    enabled: true
    autoSync: true          # 启动时自动扫描
    autoConnect: true       # 自动连接到发现的 MCP 服务器
    syncInterval: 60000     # 定时同步间隔（ms），0 关闭
    dedupeByCommand: true   # 按 command+args 去重
    registerTools: true     # 自动注册 MCP 工具到 DSH
    sources:
      claude: true
      codex: true
      cursor: true
      dsh: true             # ~/.dsh/mcp.json

DSH MCP 配置文件

~/.dsh/mcp.json 使用标准 MCP 格式：

{
  "mcpServers": {
    "my-tool": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@my-org/mcp-server"],
      "env": { "API_KEY": "..." }
    },
    "remote-service": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

工具命名

每个 MCP 工具注册为 DSH 工具，命名规则：

• 命名工具: mcp____ — 模型直接调用
• 元工具: mcp_call — 动态调用任意 MCP 工具
• 发现工具: mcp_list_tools — 列出所有可用 MCP 工具

API（均 loopback-only）

路由	方法	说明
/api/dsh-mcp-sync/registry	GET/POST/DELETE	MCP 服务器注册表（CRUD）
/api/dsh-mcp-sync/sync	POST	从各来源同步到注册表
/api/dsh-mcp-sync/sources	GET	查看各来源配置（只读）
/api/dsh-mcp-sync/connections	GET	MCP 连接状态
/api/dsh-mcp-sync/connect	POST	连接到 MCP 服务器
/api/dsh-mcp-sync/disconnect	POST	断开连接
/api/dsh-mcp-sync/tools	GET	列出所有已发现的 MCP 工具
/api/dsh-mcp-sync/call	POST	调用 MCP 工具
/api/dsh-mcp-sync/stats	GET	获取统计信息
/api/dsh-mcp-sync/reconnect	POST	重新连接失败的服务器
/api/dsh-mcp-sync/health	GET	健康检查

侧边栏

设置页面中的「MCP Manager」标签页提供四个子视图：

• Servers: 扫描到的 MCP 服务器配置
• Connections: 连接状态和工具数量
• Tools: 所有已发现的 MCP 工具列表
• Stats: 统计信息 - 运行时间、连接成功率、工具调用统计

开发

node --check lib/index.js lib/sources.js lib/routes.js lib/mcp-client.js lib/mcp-tools.js lib/client.js

License

MIT