取消

协议版本: 2025-11-25

模型上下文协议(MCP)通过通知消息支持可选的进行中请求取消。 任何一方都可以发送取消通知,指示应终止先前发出的请求。

取消流程

当一方想要取消进行中的请求时,它会发送一个包含以下内容的notifications/cancelled 通知:

  • 要取消的请求的ID
  • 可选的原因字符串,可以记录或显示
{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "123",
    "reason": "用户请求取消"
  }
}

行为要求

  1. 取消通知必须仅引用满足以下条件的请求:
    • 之前在同一方向发出的
    • 被认为仍在进行中的
  2. 客户端绝不能取消initialize请求
  3. 对于任务增强请求,必须使用tasks/cancel请求而不是notifications/cancelled通知。任务有自己的专用取消机制,返回最终任务状态。
  4. 取消通知的接收者应该:
    • 停止处理已取消的请求
    • 释放相关资源
    • 不发送对已取消请求的响应
  5. 接收者可以忽略取消通知,如果:
    • 引用的请求未知
    • 处理已完成
    • 请求无法取消
  6. 取消通知的发送者应该忽略随后到达的请求的任何响应

时序考虑

由于网络延迟,取消通知可能在请求处理完成后到达,甚至可能在已发送响应之后到达。

双方必须优雅地处理这些竞态条件:

  sequenceDiagram
   participant Client
   participant Server

   Client->>Server: 请求 (ID: 123)
   Note over Server: 处理开始
   Client--)Server: notifications/cancelled (ID: 123)
   alt
      Note over Server: 处理可能已在<br/>取消到达前完成
   else 如果未完成
      Note over Server: 停止处理
   end

实现注意事项

  • 双方应该记录取消原因以进行调试
  • 应用程序UI应该指示何时请求取消

错误处理

无效的取消通知应该被忽略:

  • 未知的请求ID
  • 已完成的请求
  • 格错误的通知

这保持了通知的"即发即忘"性质,同时允许异步通信中的竞态条件。