MCP 超时与重试：避免重复执行副作用

先给结论

读取操作可有限重试，写操作需要幂等键或状态查询；长任务应返回任务标识而非占用连接。

判断起点

区分幂等读取、创建操作和长任务的恢复策略。本地 stdio 服务部署简单，但依赖用户环境和本机权限；远程服务便于共享，却增加身份、租户隔离、网络超时和集中审计责任。选择传输方式时应先看使用边界。

推荐做法

超时设计必须考虑请求可能已经执行。只读操作可以有限重试；创建或发送类操作使用幂等键，并提供状态查询。长任务返回任务标识、进度和取消入口。客户端不应在未知结果时自动重复具有副作用的调用。

核验重点

• 服务声明的工具与实际权限是否一致
• 传输方式和凭据存储是否适合部署环境
• 失败、超时和返回数据是否可追踪

把检查结果写成可复测记录，至少包含日期、版本、环境、输入样例和结果。这样项目升级或需求变化后，团队可以判断原结论是否仍然成立。

进一步验证

许可证检查不能只读取 API 返回的简称。需要查看许可证正文、NOTICE、仓库内额外说明和所用模型或数据的独立条款。若无法确认转载或分发权，就只保存公开元数据和原始链接，不复制 README、代码或素材到自己的页面。

常见误区

客户端超时不代表服务器没有完成，盲目重试可能创建重复数据。同时不要把“能够运行”直接解释为“适合生产”，个人试验与长期服务对权限、稳定性、监控和维护的要求不同。

如何形成自己的结论

围绕本文主题准备一个代表性样例，先记录当前方案的基线，再使用候选方案重复同一任务。比较最终正确性、人工修正、耗时、资源或调用成本以及失败恢复情况；如果结果会影响重要数据或线上服务，应先在隔离环境验证。

留下可复查记录

面对概念型问题，先画出组件和数据流：谁提供输入、哪一层做决策、外部能力在哪里调用、状态保存到哪里。然后用一个不依赖营销术语的例子走完整流程。能够说明失败发生在哪一层，才算真正理解，而不是记住项目名称。

参考来源

• MCP Specification

本文根据以上公开项目整理，不复制 README 全文。仓库功能、许可证和维护状态可能变化，使用或分发前请再次查看原始页面。