dsh-mcp-client Skill 技能

技能简介

dsh-mcp-client（@crazx/dsh-mcp-client）是 DeepSeek Agent Harness 的 MCP 客户端桥接插件，用于将外部 MCP 服务器的工具与资源接入 DeepSeek 智能体。与直接在智能体中配置 MCP 不同，这款插件提供了统一的连接管理层：自动重连、工具命名空间隔离、协议版本协商、图片结果桥接等工程细节全部封装好，部署方只需关注连接哪台服务器、传哪些参数。

核心能力

• MCP 服务器桥接：支持 stdio（本地进程）和 Streamable HTTP（远程服务）两种传输方式，自动协商 MCP 协议版本
• 工具命名空间隔离：每个外部服务器的工具有独立的 namespace 前缀（如 mcpgithubcreate_issue），避免不同服务器的同名工具冲突
• 自动重连机制：连接断开后自动以指数退避重连（500ms 起，最高 30s），最多重试 10 次；连接恢复后自动刷新工具集
• 图片结果桥接：MCP 服务器返回的图片（PNG/JPEG/WebP/GIF）在确认客户端能力后自动投影进对话
• 配置驱动：纯 YAML/JSON 配置即可连接任意 MCP 服务器，无需写代码
• 协议版本协商：优先使用 MCP 2026-07-28，自动回退到旧版协议

安装配置

前置条件：Node.js ≥ 18

安装方式（作为 DeepSeek Agent Harness 插件）：

在 harness 配置文件中添加插件条目：

plugins:
  - id: mcp-github
    name: '@crazx/dsh-mcp-client'
    config:
      serverName: github          # 工具命名空间，字母数字下划线，1-32字符
      transport: stdio             # 或 streamable-http
      command: npx
      args: ['-y', '@modelcontextprotocol/server-github']
      env:
        GITHUB_TOKEN: !!js process.env.GITHUB_TOKEN

对于远程 HTTP 服务器：

plugins:
  - id: mcp-web
    name: '@crazx/dsh-mcp-client'
    config:
      serverName: web
      transport: streamable-http
      url: http://localhost:3000/mcp
      headers:
        Authorization: 'Bearer ${process.env.MCP_TOKEN}'

使用步骤

1. 在 harness 配置中注册插件，指定 serverName 和传输方式
2. 如使用 stdio 传输，准备好对应的 npm 包（如 @modelcontextprotocol/server-github）并配置好环境变量
3. 启动 harness，插件自动连接 MCP 服务器并同步工具列表
4. 在提示词中直接调用工具，例如「用 mcpgithubcreate_issue 创建一个 Issue」
5. 如需排查问题，查看 harness 日志中的 mcp-client/status 事件

适用场景

• 多 MCP 服务器并行接入：需要同时使用 GitHub、文件系统、数据库等多个 MCP 服务器的复杂 Agent 场景
• 动态增减 MCP 服务器：配置驱动，无需修改代码即可切换服务器列表
• 需要稳定长连接：内置重连机制，适合长时间运行的 Agent 任务
• 工具名冲突场景：不同服务器有同名工具（如都有 search），namespace 隔离避免冲突

适用人群

• DeepSeek Agent Harness 用户：需要管理多个外部 MCP 服务器的部署方
• Agent 框架开发者：希望将 MCP 能力整合进自有框架的开发者
• 企业级 Agent 运维：需要稳定可靠 MCP 连接方案的技术团队

工作原理

插件激活时，连接监督器（Connection Supervisor）根据传输类型启动子进程（stdio）或建立 HTTP 连接（streamable-http）。连接建立后，通过 MCP 协议的 tools/list 握手获取服务器工具列表，并注册到智能体的工具表中。工具调用时，插件将调用转发给 MCP 服务器，并将结果（文本、图片）投影回对话上下文。连接断开时，监督器自动进入重连循环；工具列表变化时，通过 MCP 协议的通知机制自动刷新注册表。

官方链接

• npm：https://www.npmjs.com/package/@crazx/dsh-mcp-client
• GitHub：https://github.com/aka-danielZhang/deepseek-harness