协议版本: 2025-06-18
Model Context Protocol (MCP) 支持通过通知消息来选择性取消正在进行的请求。任何一方都可以发送取消通知，表明先前发出的请求应当被终止。

​
取消流程

当一方希望取消一个进行中的请求时，它会发送一个 notifications/cancelled 通知，其中包含：
  • 要取消的请求的ID
  • 一个可选的可被记录或显示的原因字符串
{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "123",
    "reason": "User requested cancellation"
  }
}

​
行为要求

  1. 取消通知 必须 仅引用满足以下条件的请求：
    • 先前在同一方向发布过
    • 被认为仍在进行中
  2. 客户端 不可 取消initialize请求
  3. 接收取消通知的智能体 应当:
    • 停止处理已取消的请求
    • 释放关联资源
    • 不对已取消的请求发送响应
  4. 接收方 可以 忽略取消通知，如果：
    • 引用的请求未知
    • 处理已完成
    • 该请求无法取消
  5. 取消通知的发送方 应该 忽略之后收到的任何请求响应

​
时序考量

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

​
实现说明

  • 双方应该记录取消原因以便调试
  • 应用用户界面必须在请求取消时给出提示

​
错误处理

无效的取消通知 应当 被忽略：
  • 未知请求ID
  • 已完成的请求
  • 格式错误的通知
这保持了通知“发送后无需理会”的特性，同时允许异步通信中的竞争条件。