前言¶
DeepSeek Harness(DSH)的设计理念是“一切皆插件”,Agent 在本地通过 DSH 调用文件、搜索等能力。Model Context Protocol(MCP)则是目前 Agent 工具调用的标准协议。现有的 dsh-mcp-client 解决的是“如何把外部 MCP 服务接入 DSH”的问题,而 dsh-mcp-bridge 解决的是反向问题:如何把 DSH 的能力暴露给外部的 MCP 客户端(如 Claude Code、Codex)。
下面介绍这个插件的使用方法。
这是什么¶
dsh-mcp-bridge 是一个将 DeepSeek Harness 工具集转换为标准 MCP 服务器(通过流式 HTTP)的插件。它允许任何 MCP 兼容的客户端通过 HTTP 端点访问 DSH 的工具。
- 所有者:liiiubai
- 类别:联网工具
- 许可证:MIT
- Stars:1
该插件运行在 DSH 的沙箱与审批流程之上,确保外部调用经过安全验证。
核心功能¶
- 标准 MCP 服务器:将 DSH 工具暴露为 MCP 协议服务,支持流式传输。
- 多客户端支持:可以被 Claude Code、Codex 或任何遵循 MCP 协议的客户端/SDK 驱动。
- 安全控制:提供安全的允许列表机制,仅暴露低风险工具(read, glob, grep, web_search),并通过硬性拒绝列表防止危险命令(如 write, edit, pwsh)被误用。
- 零依赖:纯 JavaScript 实现,无需构建步骤。
- 原生沙箱:所有工具调用依然经过 DSH 的沙箱隔离与审批流程。
安装与启用¶
安装过程通过 DSH 的插件命令完成。
- 执行安装命令:
dsh plugin --profile <name> add github:you/dsh-mcp-bridge
*注意:请将 `<name>` 替换为你实际使用的 DSH 配置文件名。*
- 插件会自动挂载一个
cordis.patch.yml配置文件,将服务端点挂载到/mcp。
典型用法¶
安装完成后,配置允许列表并连接客户端。
- 编辑你的
cordis.patch.yml,调整端点路径和允许的工具:
- id: mcp-bridge
config:
path: /mcp # 端点路径
allowlist: # 暴露给 MCP 客户端的 DSH 工具
- read
- glob
- grep
- web_search
- 连接 Claude Code 或其他 MCP 客户端:
claude mcp add --transport http dsh http://127.0.0.1:3080/mcp
客户端将识别出以 `dsh_` 开头的工具(例如 `dsh_read`, `dsh_glob`)。
适用场景与注意¶
- 适用场景:当你需要在非 DSH 环境下的 Agent(如 Claude Code)中直接使用 DSH 的文件读取、搜索或网络搜索能力时使用。
- 安全注意事项:
- 默认允许列表仅包含只读、低风险工具。修改配置时请谨慎添加写操作。
- 服务端点必须绑定在
127.0.0.1(回环地址),不要绑定到0.0.0.0,除非你完全信任网络环境。
- 双向通信:
dsh-mcp-bridge目前只支持“外部客户端 -> DSH”的单向暴露。如果你需要在 DSH 内部连接外部 MCP 服务器,请使用官方的@deepseek-ai/dsh-mcp-client插件。
结尾¶
dsh-mcp-bridge 让 DSH 不仅能作为工具使用者,也能作为工具提供者融入 MCP 生态。通过简单的配置和 HTTP 端点,即可在各类 Agent 中复用 DSH 的安全能力。