1.1 MCP 与 dsh-mcp-client：工具怎么进来

MCP 是什么，一段话说清

Model Context Protocol 是基于 JSON-RPC 的开放协议，用来把 LLM 应用（宿主）和外部系统连起来。一个 MCP 服务器暴露三类东西：

概念 作用 例子
Tools 模型可调用的函数 create_issue、search_web
Resources 可读取的数据与上下文 config://app/settings
Prompts 可复用的提示模板 weekly-report

对绝大多数使用者，你只用得到 Tools。Resources 和 Prompts 是给服务器作者用的，配置和使用时基本不用管。

dsh 侧的接入链路

你的 cordis.patch.yml
   └─ @deepseek-ai/dsh-mcp-client 插件被装载
        ├─ stdio：启动配置的 command 作为子进程，随插件生命周期启停
        └─ streamable-http：连接配置的 URL（上游必须已在运行）
             └─ 初始化握手，发现工具
                  └─ 以 mcp__<serverName>__<tool> 公开给模型

注意最后那个命名规则：mcp__<serverName>__<tool>，双下划线分隔。你在会话里看到的工具名长这样：mcp__playwright__browser_navigate。

这个前缀非常有用——一眼就能看出某个工具来自哪个 MCP 服务器，排错时先看前缀就能定位到是哪一个接入出了问题。

三种给 agent 加能力的方式，别混

MCP 只是其中一种。dsh 里给 agent 扩展能力有三条路，适用场景不同：

方式 本质 适合
技能（skill） 纯指令包，零部署 只是方法论、固定流程
插件（plugin） 代码模块，注册到 ctx.tools 需深度集成 dsh 内部能力
MCP 服务器 标准协议，独立进程 复用现成生态 / 跨工具共享

判断口诀：只是想让 agent 按某套做法做事 → 写技能；要调 dsh 内部能力 → 写插件；要接一个已经存在的服务或跨多个客户端复用 → 用 MCP。 别为了“调一个 API”硬写技能，也别为了“固化一套流程”硬建 MCP 服务器。

为什么需要这层客户端

有人会问：dsh 自己就有 Bash 和文件系统，为什么还要 MCP？

因为 Bash 只能做本机能做的事。MCP 把边界推到：

  • 云端服务（GitHub、Notion、Slack）；
  • 数据库（Postgres、MySQL）；
  • 浏览器（Playwright）；
  • 你公司的内部 API。

而且一次编写、处处可用：同一个 GitHub MCP 服务器，Claude、Cursor、dsh 都能连。这也是为什么 MCP 值得单独成书推荐——它接入的是整个外部世界，而不只是本机。

一个重要的现实：没有“MCP 的 DNS”

服务器发现是当前生态最难的未解问题。Anthropic 官方 registry、Smithery、Cline marketplace 各有索引，集合重叠但不完全相同。

所以本书的做法是：每个推荐都给出已核验的仓库地址或包名，你自己判断可信度。官方也对第三方配置表了态——收录仅作互操作参考，不代表认可、推荐、合作关系或持续支持承诺。这句话要记牢：书里推荐的第三方服务器，是“经过互操作验证能接进 dsh”，不代表 DeepSeek 为其背书。

2026 年的生态快照

几个可参考的方向性数据（2026 年 3 月 Ahrefs 全球搜索量，无中国区数据）：

排名 服务器 月搜索量
1 Playwright 82k
2 Figma 74k
3 GitHub 69k
4 Jira / Atlassian / Confluence 40k
5 Context7 32k
13 Sequential Thinking 13k
29 Filesystem 4.9k
40 Memory 3k
41 Fetch 2.9k

两个读法：浏览器与设计协作类最热；官方参考服务器搜索量反而不高，但这不代表它们不好用——恰恰因为它们太基础，大家直接装不再搜索。

另一点：前 50 名里 42 个是工程师在用，说明 MCP 目前仍是开发者工具。本书的推荐也以开发者日常场景为主。

规格版本

当前稳定版规格日期为 2025-11-25。2026-07-28 的 RC 正在推进，计划带来无状态核心、扩展框架、沙箱化 MCP Apps 与 OAuth 加固。

对使用者的实际影响：如果某个服务器突然不兼容，先看它支持的规格版本。 本书推荐以官方参考服务器和活跃维护的社区服务器为主，风险较低。

接入前自检清单

动手接任何一个 MCP 之前，先过一遍：

检查项 通过了再装
这个服务器解决我的什么具体问题 不为了解决而解决
是 stdio 还是 HTTP 形态 决定配置写法
上游是否已安装 / 已运行 stdio 要装，HTTP 要起服务
需要什么密钥，怎么进 config.env 别写进 YAML
有没有已核验的来源（仓库 / 包名 / star 数） 防装到废弃包

小结

  • MCP 暴露 Tools / Resources / Prompts，你主要用 Tools。
  • dsh 通过 @deepseek-ai/dsh-mcp-client 接入，工具名前缀 mcp__<serverName>__<tool>。
  • 给 agent 加能力有技能 / 插件 / MCP 三条路，按集成深度选。
  • 服务器发现没有统一入口，本书给已核验来源，可信度自行判断。
  • 2026 年生态最热是浏览器与设计协作；官方参考服务器基础但稳定。

延伸阅读