第 1 周 · D3🔒 锁定约 5 小时
resources 与 prompts:URI 模板、变更通知、进度与日志、分页,以及客户端能力
把只读数据做成资源、把重复问法做成提示模板,再补齐 URI 模板、分页、进度、订阅与缓存这几件让服务端在真实数据量下还能用的事。
今日目标
- 能判断一份数据该做成资源还是做成工具,并说出判断依据
- 能用 URI 模板暴露一组参数化资源,并为列表接口实现游标分页
- 能说清订阅流与请求内通知的区别,并各举一个使用场景
昨天你的服务端只有工具,一共两个,谁调都一样快。今天换一份真实体量的数据进来——几千篇笔记——你会立刻撞上分页、缓存和通知这三堵墙。完整的报文骨架 D1 已经拆过一遍,今天只看新增的那几个字段。读完回来把上面三条勾掉。
小白版讲解
资源是应用驱动的:谁决定它进不进上下文
先回到插座那个类比。工具像是电器上的开关:模型看着说明书自己按。资源不一样,它更像插排上贴的标签——宿主应用或用户扫一眼,决定这一路要不要通电。
规范把这件事说得很直白:资源是"应用驱动"(application-driven)的,由宿主应用决定怎么把它并进上下文。典型的界面形态是一个文件选择器、一棵目录树,或者一个搜索框;也可以由应用按启发式规则自动带上。而工具是"模型控制"的,模型看着描述自己挑。
所以同一份数据做成哪一种,判据不是"它是什么",而是这一次由谁来决定用不用它:
| 情况 | 做成 |
|---|---|
| 只读、可枚举、希望用户在界面上挑 | 资源 |
| 会产生副作用,或要由模型自己判断何时使用 | 工具 |
| 需要一次检索出结果,而不是先列后读 | 工具(哪怕它是只读的) |
最后一行是最容易搞错的地方。"搜索代码"看起来是只读的,像资源,但它没法枚举——你不可能把所有可能的查询词列成一张清单让用户挑。能不能被列出来,是资源和工具之间那条最实用的分界线。
这条分界线还有一个说不出口但很现实的好处:资源不进上下文就不花钱。工具的定义无论用不用,每一轮都要塞进请求里;资源只是一条清单项,宿主不选它就一个 token 都不占。一个有三千篇文档的知识库,做成三千个工具会直接把上下文撑爆,做成资源则只在用户点中那一篇时才付费。
问题也就跟着来了:三千篇笔记,resources/list 一次性全吐回去吗?
面试题库
同一份数据,做成 MCP 资源和做成工具有什么区别?你按什么标准选?For the same data, what is the difference between exposing it as an MCP resource versus a tool, and how do you choose?
国内高频海外高频基础#primitives#server-design🔒 解锁本章后查看答题要点。
MCP 的分页游标为什么必须是不透明的?如果客户端去解析它,会出什么问题?Why must MCP pagination cursors be opaque, and what breaks if a client parses them?
国内高频海外高频进阶#pagination#api-design🔒 解锁本章后查看答题要点。
订阅流和请求内的进度通知在 HTTP 上都走 SSE,为什么 2026-07-28 规范要把它们分成两个通道?On HTTP both subscription streams and in-request progress notifications ride SSE, so why does the 2026-07-28 spec split them into two channels?
国内高频海外高频深入#subscriptions#notifications🔒 解锁本章后查看答题要点。
