分页 - Model Context Protocol 中文文档

Model Context Protocol (MCP) 支持对可能返回大型结果集的列表操作进行分页。分页允许服务器以较小的数据块分批生成结果，而不是一次性返回全部结果。当连接到互联网上的外部服务时，分页尤其重要；对于本地集成，它也有助于避免大数据集带来的性能问题。

分页模型

MCP 中的分页使用基于不透明游标的方式，而不是编号页。

当服务器发送包含以下内容的响应时，分页开始：

{
  "jsonrpc": "2.0",
  "id": "123",
  "result": {
    "resources": [...],
    "nextCursor": "eyJwYWdlIjogM30="
  }
}

收到游标后，客户端可以通过发出包含该游标的请求来_继续_分页：

{
  "jsonrpc": "2.0",
  "id": "124",
  "method": "resources/list",
  "params": {
    "cursor": "eyJwYWdlIjogMn0="
  }
}

以下 MCP 操作支持分页：

服务器 SHOULD：
- 提供稳定游标
- 妥善处理无效游标
客户端 SHOULD：
- 将缺失的 nextCursor 视为结果结束
- 同时支持分页和非分页流程
客户端 MUST 将游标视为不透明令牌：
- 不要假定游标格式
- 不要尝试解析或修改游标
- 除判断是否提供了非 null 值之外，不要基于游标值作出任何判断（例如，空字符串是有效游标，因此 MUST NOT 被视为结果结束）

无效游标 SHOULD 导致代码为 -32602（Invalid params）的错误。