dsh-mcp-sync

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

v0.6.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 端点一键重连失败的服务器 |

工作原理

1. 扫描: 从 Claude Code / Codex / Cursor / DSH 配置文件读取 MCP 服务器定义
2. 连接: 使用 MCP SDK（stdio/SSE/HTTP transport）连接到每个服务器
3. 发现: 调用 tools/list 获取每个服务器暴露的工具列表
4. 注册: 将每个 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 | 获取统计信息（v0.6.0） | | /api/dsh-mcp-sync/reconnect | POST | 重新连接失败的服务器（v0.6.0） | | /api/dsh-mcp-sync/health | GET | 健康检查（v0.6.0） |

侧边栏

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

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

开发

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

License

MIT