分页

​

分页模型

• 游标（cursor） 是一个不透明的字符串令牌，表示结果集中的某个位置
• 页面大小（page size） 由服务器决定，客户端 不得 假设页面大小是固定的

​

响应格式

• 当前页的结果
• 如果还有更多结果，可选的 nextCursor 字段

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

​

请求格式

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

​

分页流程

​

支持分页的操作

• resources/list - 列出可用资源
• resources/templates/list - 列出资源模板
• prompts/list - 列出可用提示
• tools/list - 列出可用工具

​

实现指南

1. 服务器 应该：
   • 提供稳定的游标
   • 优雅地处理无效的游标
2. 客户端 应该：
   • 将缺失的 nextCursor 视为结果结束
   • 支持分页和不分页的流程
3. 客户端 必须 将游标视为不透明令牌：
   • 不要假设游标的格式
   • 不要尝试解析或修改游标
   • 不要在会话之间持久化游标

​

错误处理