Edge-Echo/dsh-mcp-bridge

dsh-mcp-bridge

dsh-mcp-bridge

npm version
npm downloads
license
GitHub stars

面向 DeepSeek Harness (dsh) 的精选、验证过的 MCP 全家桶插件。

一条命令装上经过实战检验的 MCP server 集合——而不是让你自己去琢磨一份 YAML。每个精选 server 在 servers/ 里有机器可读定义，scripts/verify-servers.mjs 会逐个检查连通性，所以「已验证」是 CI 保证的事实，不是宣传话术。

模型看到的工具名为 mcp____（与 Claude Code / Codex 的服务器限定命名一致）。桥接层是 DSH 内置的 @deepseek-ai/dsh-mcp-client：支持 stdio / streamable-http、自动重连、HMR 热替换。

English docs: README.md.

快速开始

前置条件：dsh 与 pnpm 在 PATH 上（dsh plugin 内部转发 pnpm；未装可 npm i -g pnpm）。

dsh plugin --profile web add dsh-mcp-bridge
本地开发：  dsh plugin --profile web add ./dsh-mcp-bridge
dsh web        # 重启 profile

默认启用 MCP 官方 everything 演示 server（无 API key，纯本地 npx）。重启后让模型「调用 everything 服务器的 echo 工具，传 hello」，它应该会用 mcp__everything__echo。

首次运行会通过 npx 下载 server 包，之后有缓存。

精选目录

| Server | 能干什么 | 需要的配置 | 验证状态 |
|---|---|---|---|
| everything | 演示工具：echo、add、长任务、小图片 | 无（默认开启） | ✅ 13 个工具 |
| memory | 会话内知识图谱（实体/关系） | 无 | ✅ 9 个工具 |
| filesystem | 文件读写/搜索，仅限显式授权的根目录 | 改 root 目录（args） | ✅ 14 个工具（给定真实目录时） |
| github | 仓库 / issue / PR | GITHUB_TOKEN | ⏸ 需配置 |
| playwright | 浏览器自动化（导航/点击/截图） | 首次需下载浏览器 | ⏸ 较重，CI 跳过 |
| remote-http | 自建 / 托管的 HTTP MCP server | URL（可选 token） | ⏸ 需配置 |

启用某个注释预设：在 profile 的 cordis.patch.yml 里取消对应注释块（HMR 热替换，无需重启），或直接改本包的 cordis.patch.yml。

自己验证目录

npm install          # 会带入 @deepseek-ai/dsh-mcp-client → MCP SDK
npm run verify       # 或：node scripts/verify-servers.mjs

逐个打印 PASS / SKIP / FAIL，有失败时退出码非 0。VERIFY_TIMEOUT_MS=15000 可调单 server 超时。单 server 排障：node scripts/probe-server.mjs npx -y your-mcp-server。

添加自己的 MCP server

每个 server 就是一条 @deepseek-ai/dsh-mcp-client 条目。推荐加到 profile 的用户 patch 层（HMR 即时生效）：

$DSH_HOME/profiles//cordis.patch.yml
- id: mcp-myserver
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: myserver          # 命名空间，进程内唯一（[A-Za-z0-9_-]{1,32}）
transport: stdio              # 或 streamable-http
command: npx
args: ['-y', 'your-mcp-server']
env:
YOUR_TOKEN: !!js process.env.YOUR_TOKEN

或者：把定义放进 servers/（这样 verify 会覆盖它），并在本包 cordis.patch.yml 里加对应条目。

配置字段速查（来自 dsh-mcp-client）

| 字段 | 传输 | 必填 | 说明 |
|---|---|---|---|
| transport | 两者 | 是 | "stdio" 或 "streamable-http" |
| serverName | 两者 | 是 | 工具命名空间，存活实例内唯一 |
| command / args / env / cwd | stdio | command 必填 | 子进程规范 |
| url / headers | http | url 必填 | 端点 + 认证头 |
| toolCallTimeoutMs | 两者 | 否 | 单次调用超时，默认 60000 |
| failOnStartupError | 两者 | 否 | 连接失败时拒绝激活（默认 false） |
| reconnect. | 两者 | 否 | 自动重连退避（默认开启） |

与 Reasonix / CodeWhale 联动

三者都是 agent harness——MCP 就是共同语言。你给 Reasonix / CodeWhale 配的任何 server 都能加到这里；自建的 streamable-http server 可以让 DSH、Reasonix、CodeWhale 共用一个进程。见 servers/remote-http.json。

排错（Windows）

- headless 验证挂起（dsh --profile  "任务"）：profile 需要在 dsh.profile.bundles 里手动加 @deepseek-ai/dsh-headless（dsh plugin add @deepseek-ai/dsh-headless 会因其未发布依赖 404 失败）。缺它时树能激活但没有 agent 消费任务。
- Windows 下 npx 正常可用：MCP SDK 使用 cross-spawn，能解析 .cmd shim，不需要 npx.exe。
- server 连上了但没有工具：看 profile 日志；failOnStartupError: false 时失败条目会静默激活但不注册工具。

发布（npm）

1. npm version patch（或手动改 package.json），提交，打 tag vX.Y.Z。
2. git push origin main --tags。
3. GitHub Actions（publish.yml）自动发布到 npm——需要 npm trusted publisher（OIDC）关联仓库。设置：npm → Access Tokens → Generate new token → Publish with GitHub Actions*。

给仓库打上 GitHub topic dsh-plugin，这样会出现在社区列表里（awesome-dsh-plugin、WhaleHub）。

License

MIT — 见 LICENSE。