DeepSeekDSH
独立社区指南与 DeepSeek 无隶属关系。官方源码快照

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 已经连通?

  1. 启动包含 MCP Client 配置的 DSH Profile。
  2. 确认预期的 mcp__server__tool 工具名已经出现。
  3. 先让 Agent 调用一个无副作用、只读的 MCP 工具。
  4. 核对工具调用结果与 MCP Server 实际发生的行为。
  5. 短暂停止或重启 MCP Server,再检查自动重连是否符合预期。
主要来源

DeepSeek Harness 官方 dsh-mcp-client 中文 README。DSH 仍处于开发者预览阶段,配置项和能力边界可能随版本变化。