MCP工具超时取消核验工作流

MCP工具超时取消核验工作流

4个实用技能 · 4步完成 · 每一步都能单独使用

把 MCP 工具调用的预期时长、客户端上限、进度通知、取消原因和失败日志整理成可回读证据：先建立超时合同，再审计进度与取消语义，随后区分真实超时、人工取消、进度停滞和会话丢失，最后生成默认不放行的长任务复核单。套餐只处理买家提供的脱敏 JSON，不连接 MCP 端点、不执行工具、不发送取消通知。

4个可下载技能 · 每个技能可单独运行

4步自动化工作流

🔵 1 MCP工具超时合同整理

技能文件：mcp-timeout-contract-normalizer

解决什么： 不同 MCP 客户端和工具对预期时长、最大等待、进度刷新和取消策略的约定常常分散，导致长任务在同一套系统中被过早终止或无限等待。

What you get: READY/REVIEW、工具时延画像、请求方上限、服务方建议、进度窗口、取消策略和 timeout_contract_hash。

↓ 本步结果自动进入下一步

🟢 2 MCP进度取消审计

技能文件：mcp-progress-cancellation-auditor

解决什么： 只有取消请求而没有 requestId、reason 或 timeout 证据，或者进度长期停滞却继续占用连接时，日志很难解释到底发生了什么。

What you get: PASS/REVIEW/CANCEL_RISK、进度间隔、取消引用、取消原因、超时字段、取消后的消息违规和 progress_cancellation_hash。

↓ 本步结果自动进入下一步

🟠 3 MCP超时失败分类

技能文件：mcp-timeout-failure-classifier

解决什么： SDK 把人工 Abort、请求超时、服务端超时和会话丢失映射成相同错误码时，自动重试可能重复执行有副作用的工具。

What you get: CLASSIFIED/AMBIGUOUS、requester_timeout、server_timeout、manual_cancel、progress_stall、session_loss 或 unknown 分类，以及 timeout_failure_hash。

↓ 本步结果自动进入下一步

🟣 4 MCP长任务发布门禁

技能文件：mcp-longrun-release-gate

解决什么： 静态检查通过不等于可以把长任务接入生产重试或自动恢复；团队还需要负责人、策略和证据引用，决定是否继续上线。

What you get: READY_FOR_HUMAN_REVIEW/HOLD、风险原因、human_decision=PENDING、retry_allowed=false 和 longrun_gate_hash。

↓ 本步结果形成最终交付

实际示例

脱敏样例模拟一个建议 120 秒但客户端上限 30 秒的工具调用：进度间隔超过约定窗口，取消通知缺少可判定的超时字段，取消后仍出现结果消息，失败日志同时含有 AbortSignal 和 REQUEST_TIMEOUT。第一步输出超时合同；第二步标记 CANCEL_RISK；第三步输出 AMBIGUOUS；第四步生成 HOLD 复核单。示例只验证本地规则，不代表真实 MCP 服务器行为。

适合谁

• 维护 MCP 客户端、工具服务器或长耗时数据处理工具的工程团队

• 负责客户端超时、取消、进度通知和重试策略的平台团队

• 需要区分人工停止、网络超时、服务端超时和会话丢失的可观测性与 QA 团队

• 在生产启用长任务、异步工具或持续连接前需要保留人工批准证据的服务商

买家只需提供

• 已脱敏的工具时延样本、客户端最大等待、服务端建议和进度窗口

• 请求事件、progressToken、进度通知、cancelled 通知和取消后的消息序列

• SDK 错误码、Abort 或手动停止标记、会话状态和重试策略

• 负责人、决策单号、运行策略引用和允许自动重试的边界

使用方式

1. 使用 Python 3.10 或更高版本，将合同、事件和日志写成 UTF-8 JSON；不要放入密码、Cookie、访问令牌、真实客户数据或私有载荷。

2. 依次运行超时合同整理、进度取消审计、失败分类和长任务发布门禁，也可以单独运行任一步。

3. 在隔离测试环境查看结果，由有权限的负责人决定是否调整客户端上限、服务端进度策略或重试规则；套餐本身不会改变这些配置。

交付与验收

• 四个独立技能目录，每个包含元数据、技能说明、标准库执行器、文档和脱敏样例。

• 四步可重复运行：超时合同、进度取消审计、失败分类、人工发布门禁；每个技能也能单独使用。

• 缺少时延合同、进度停滞、取消引用不完整、取消后继续发消息、错误分类冲突或证据不足时，输出明确的 REVIEW、CANCEL_RISK、AMBIGUOUS 或 HOLD 分支。

• 正常样例保留 human_decision=PENDING、retry_allowed=false 和 external_action_executed=false；不替代真实负载测试、SDK 兼容测试、网络诊断或工具幂等性证明。

服务说明

脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接 MCP、DNS、TLS、数据库或远程 API，不读取凭据，不发送请求，不执行取消，不重试工具，也不改变外部状态。静态事件检查不能证明远端服务健康、工具幂等、客户端一定遵守超时或取消策略；分类结果依赖买家提供的日志字段。MCP 协议和 SDK 会变化，正式使用前必须由协议、平台和安全负责人复核。本套餐不承诺绝对不超时、零重复执行、固定兼容或固定节省比例。