取消 - Model Context Protocol 中文文档

Model Context Protocol (MCP) 支持通过通知消息可选地取消正在进行的请求。任一方都可以发送取消通知，表示应终止先前发出的请求。

取消流程

当一方希望取消正在进行的请求时，它会发送一个 notifications/cancelled 通知，其中包含：

{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "123",
    "reason": "User requested cancellation"
  }
}

取消通知 MUST 仅引用符合以下条件的请求：
- 先前已在同一方向发出
- 被认为仍在进行中
客户端 MUST NOT 取消 initialize 请求
对于任务增强请求，MUST 使用 tasks/cancel 请求，而不是 notifications/cancelled 通知。任务有自己专用的取消机制，会返回最终任务状态。
取消通知的接收方 SHOULD：
- 停止处理被取消的请求
- 释放关联资源
- 不为被取消的请求发送响应
在以下情况下，接收方 MAY 忽略取消通知：
- 引用的请求未知
- 处理已经完成
- 请求无法取消
取消通知的发送方 SHOULD 忽略随后到达的该请求的任何响应

由于网络延迟，取消通知可能在请求处理完成后才到达，甚至可能在响应已经发送后才到达。双方 MUST 优雅处理这些竞态条件：

无效的取消通知 SHOULD 被忽略：

这会保持通知“发送后即忘”的性质，同时允许异步通信中存在竞态条件。