DeepSeek Harness MCP 客户端
DeepSeek Harness 自带官方 MCP Client 插件,可连接外部 MCP Server,并把服务器提供的工具注册成 DSH 原生工具。
本页内容
DeepSeek Harness 支持 MCP 吗?
支持。 DSH 官方发行版包含 @deepseek-ai/dsh-mcp-client 插件。它负责连接外部 Model Context Protocol Server、发现工具,并把这些工具注册到 Harness 的工具系统。
MCP Server 不会默认启用;需要用哪个 Server,就为它增加一条 MCP Client 配置。
在 DeepSeek Harness 中配置 MCP Server
官方插件采用“一条配置对应一个 Server”的方式。本机 stdio Server 可以使用类似下面的配置:
- id: mcp-github
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: github
transport: stdio
command: npx
args: ['-y', '@modelcontextprotocol/server-github']敏感凭据尽量不要直接写进配置文件。官方示例也是通过环境变量提供 Token,而不是把真实密钥硬编码进去。
MCP 工具在 DSH 中叫什么?
发现成功后,工具会以带 Server 命名空间的名称暴露给模型,例如 mcp__github__create_issue。通用形式是:
mcp__<serverName>__<tool>这样不同 MCP Server 即使都有同名工具,也不会互相冲突。如果希望会话历史、权限规则与模型看到的工具名保持稳定,就不要随意修改 serverName。
stdio 和 Streamable HTTP 怎么选?
stdio
适合 MCP Server 作为本机子进程运行的情况。配置执行命令、参数、可选工作目录,以及该进程真正需要的环境变量。
Streamable HTTP
适合 MCP Server 以服务形式运行的情况。配置 URL 与所需 Header;非本机服务应使用 TLS,并尽量缩小凭据权限范围。
MCP Server 断线后会怎样?
当前官方 MCP Client 默认会在连接丢失后自动重连。重连延迟会从 500 ms 逐步退避到最多 30 秒,默认连续尝试上限为 10 次。
断线期间,之前发现的工具可能仍然显示,但调用会失败;超过重连尝试上限后,相关工具会被移除,直到重新加载配置或重启 DSH。
当前 DeepSeek Harness MCP 的能力边界
- 当前桥接的是 MCP Tools。 MCP Resources 与 Prompts 暂时没有 Harness Consumer。
- 工具描述和输入 Schema 在注册期间会进入请求上下文,因此会增加一定 Token 占用。
- Server 发现过慢会拖慢初始化;工具调用失败会明确显示失败,不会伪装为成功。
- 修改 Server Name 会改变模型看到的工具命名空间。
如何验证 MCP 已经连通?
- 启动包含 MCP Client 配置的 DSH Profile。
- 确认预期的
mcp__server__tool工具名已经出现。 - 先让 Agent 调用一个无副作用、只读的 MCP 工具。
- 核对工具调用结果与 MCP Server 实际发生的行为。
- 短暂停止或重启 MCP Server,再检查自动重连是否符合预期。
DeepSeek Harness 官方 dsh-mcp-client 中文 README。DSH 仍处于开发者预览阶段,配置项和能力边界可能随版本变化。