版本:v0.1.2|项目开源,NPM 已发布

简介

DeepSeek Harness(简称 dsh)是 DeepSeek 推出的本地 Agent 运行框架,框架原生提供了 MCP(Model Context Protocol)客户端能力,但属于裸引擎,没有预置可直接使用的 MCP 服务配置

普通开发者想要给 Agent 配置 MCP 工具,需要自行寻找各个 MCP 服务、处理依赖、手写配置、排查 stdio 通信异常,上手门槛很高。

dsh-mcp-bridge
dsh‑mcp‑bridge 就是为解决该问题开发的 DSH 插件,一条命令即可接入 6 类经过真机验证的 MCP 服务,让本地 AI Agent 具备文件操作、浏览器自动化、GitHub 操作、知识记忆、对接远程 MCP 服务的能力。

工具命名规范对齐 Claude Code / Codex,生态互通。

解决的核心痛点

  1. DSH 原生仅提供 MCP 客户端,无开箱即用服务配置;
  2. 分散的 MCP 服务需要逐个部署,依赖、配置调试成本高;
  3. 很多 MCP 套件缺少真实连通校验,文档写可用实际跑不通。本项目提供真机实测的 MCP 服务集合,配套本地校验脚本 + GitHub CI 自动化验证,可用性有客观保障。

内置 MCP 服务列表

默认启用 everything 演示服务,其余服务取消注释即可开启。

服务名称功能说明配置要求
everythingMCP 官方演示工具,支持 echo、求和、长任务模拟无需配置
memory会话知识图谱,实现实体、关系记忆能力无需配置
filesystem限定目录下文件读写、文件检索修改允许访问的目录路径
github操作 GitHub 仓库、Issue、PR配置个人 GitHub Token
playwright浏览器自动化,网页访问、点击、页面截图首次运行自动下载浏览器内核
remote‑http接入自定义远程 MCP 服务填写远程服务 URL

快速安装使用

安装插件

bashdsh plugin --profile web add dsh-mcp-bridgedsh web

验证插件是否正常工作向模型发送指令:

Plain Text调用 MCP everything 服务器的 echo 工具,传 hello
模型返回 Echo: hello 即代表整条 MCP 调用链路完全通。

可用性保障(项目核心亮点)

区别于很多仅文档声明 “开箱即用” 的项目,本项目具备两层自动化校验手段:

  1. 本地校验脚本 scripts/verify-servers.mjs:批量连接各个 MCP 服务,输出 PASS / SKIP / FAIL 运行状态;
  2. GitHub Actions CI 流水线:每次代码提交自动执行连通测试,可用性由 CI 执行结果保证,并非单纯宣传。实测可用工具统计:
  • everything → 13 个工具 ✅
  • memory → 9 个工具 ✅
  • filesystem →14 个工具 ✅(合法访问目录)

主要技术特性

  • 基于官方 @deepseek-ai/dsh-mcp-client 开发,不重复造轮子;
  • 同时支持 stdiostreamable‑http 两种 MCP 标准传输协议;
  • 断线自动重连,指数退避策略;重连后更新工具注册,无重复注册、无内存泄漏;
  • 配置支持 HMR 热替换,修改配置无需重启进程;
  • 工具名通过纯函数生成,不受连接顺序、重连行为影响;
  • MCP 协议跨 Agent 框架兼容,可复用 Reasonix、CodeWhale 的 MCP 服务。

小提示:自建的 streamable‑http MCP 服务,可以同时被多个 Agent 框架共用。

项目资源地址

仓库包含 Banner 图、状态徽章、双语 README、CI 校验流水线,MIT 开源协议。

后续规划与参与贡献该项目完整走完编码开发、本地调试、NPM 发布、开源、提交生态 PR 完整流程。后续版本计划实现 GitHub 能力增强、接入数据库类 MCP 服务。

如果你觉得项目对你有帮助:

⭐ GitHub 点 Star,是对开发者最大鼓励

🐛 发现问题欢迎提交 Issue

🔧 欢迎提交 PR,新增服务、优化逻辑

让 DeepSeek Harness 对接整个 MCP 生态,就从 dsh‑mcp‑bridge 开始。

DeepSeek HarnessMCPAI Agent大模型工具调用开源插件

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐