前言¶
DSH 的插件生态强调「一切皆插件」。对需要给智能体接入 MCP 工具的开发者来说,手动整理服务器命令、传输方式、工具命名和启动失败行为,容易出现配置差异。dsh-mcp-bridge 把一组常用 MCP 服务器打包为 DSH 插件,并提供连接性验证脚本,便于先确认服务器可连接,再交给模型使用。
这是什么¶
dsh-mcp-bridge 是一个面向 DeepSeek Harness(dsh)的 MCP 服务器 bundle。一次安装可提供 demo、memory、filesystem、GitHub、Playwright 和 remote HTTP 这几类 MCP 服务器。
它使用 DSH 内置的 @deepseek-ai/dsh-mcp-client,支持 stdio 和 streamable-http、自动重连和 HMR hot-swap。每个整理过的服务器在 servers/ 下有机器可读定义;scripts/verify-servers.mjs 会检查每个服务器的连接性,使 “verified” 成为一个可由脚本复核的主张。
仓库地址:
https://github.com/Edge-Echo/dsh-mcp-bridge
许可证:
MIT
核心功能¶
默认开启的 demo 服务器¶
everything demo 服务器默认启用,无需 API key。它提供 echo、add、long-running ops 和 tiny image 工具。安装并重启后,可以让模型调用 mcp__everything__echo。
其他服务器¶
memory:提供会话内知识图谱的 entities 和 relations。filesystem:支持文件读取、写入、搜索,范围限定在显式 roots。github:支持仓库、issues 和 PRs,需要GITHUB_TOKEN。playwright:支持浏览器自动化,例如 navigate、click、screenshot。remote-http:支持接入自有或托管的 HTTP MCP server,需要 URL,可选 token。
工具在模型侧以 mcp__<serverName>__<toolName> 形式出现。
安装与启用¶
前置条件:dsh 和 pnpm 需要在 PATH 中。dsh plugin 会转发到 pnpm。若本机没有 pnpm,可先执行:
npm i -g pnpm
安装插件:
dsh plugin --profile web add dsh-mcp-bridge
如果从本地 checkout 安装:
dsh plugin --profile web add ./dsh-mcp-bridge
重启 profile:
dsh web
首次运行会通过 npx 下载服务器包,后续运行会缓存。
典型用法¶
重启后,可以在对话中要求模型:
call the everything server's echo tool with hello
模型应使用 mcp__everything__echo。
如果要启用注释掉的预设,需要取消 profile 的 cordis.patch.yml 中对应服务器块的注释。
验证与排查¶
在仓库目录中执行:
npm install
npm run verify
也可以直接执行:
node scripts/verify-servers.mjs
npm install 会引入 @deepseek-ai/dsh-mcp-client,它对应 MCP SDK。
如需调整每个服务器的超时时间,可设置:
VERIFY_TIMEOUT_MS=15000 npm run verify
排查单个服务器时,可执行:
node scripts/probe-server.mjs npx -y your-mcp-server
如果配置了 failOnStartupError: false,连接失败时 entry 仍可能激活,但没有可用工具。
适用场景与注意¶
适合需要快速给 dsh agent 接入一组 MCP 工具,并希望先做连接性检查的开发者。
使用前需要注意:
- 插件以当前 dsh 进程权限运行,安装前应检查源码和许可证。
filesystem需要显式 root dir。github需要GITHUB_TOKEN。remote-http需要 URL,可选 token。playwright首次运行需要下载浏览器,体积较重,且被排除在 CI 外。- Node 引擎要求
>=22。 - 如果 profile 需要
@deepseek-ai/dsh-headless出现在dsh.profile.bundles中,headless verification 可能挂起;直接执行dsh plugin add @deepseek-ai/dsh-headless会因其未发布依赖返回 404。 - DSH 社区目录是独立站点,与 DeepSeek 或幻方没有官方从属关系,不要把它理解为官方应用商店。
链接¶
GitHub:
https://github.com/Edge-Echo/dsh-mcp-bridge