MCP工具列表不完整:分页游标检查

接入MCP后只看到几项工具,不一定代表服务器只提供这些能力。列表操作可能分页返回,客户端需要读取下一页游标,才能判断发现过程是否结束。

浅色文档资料架与检索放大镜
浅色主题概念配图,选自本站AI生成图库;非事件现场或产品实测截图。

根据结束标志而不是条数判断

所引规范使用不透明游标,并由服务器决定页大小。响应带nextCursor时,用该值继续请求;缺少它才表示结果结束。不能假定一页永远是十条,也不能因为当前页很短就宣布已列出全部工具。

游标按原样传递

不要尝试解析、递增或自行拼接游标,也不要跨会话保存使用。一个看似能解码的字符串仍是服务器内部约定。工具发现完成与工具获准执行是不同步骤,列表里出现写入工具不代表用户已经授权调用。

为异常分页准备可解释的出口

本站建议测试单页、多页、重复游标和无效游标四种返回。遇到重复值或页数上限时停止并明确标记发现未完成,避免无限循环。这个边界适用于客户端实现;普通业务工具的结果分页仍需遵循该工具自己的文档。

资料与继续学习

MCP 2025-06-18规范:分页。资料查阅日期:2026年10月4日。步骤与练习由本站整理。

资料查阅与编辑日期:2026年10月4日。作者:玖柒。

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享