协议版本: draft
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
  • 已经完成的请求
  • 格式错误的通知
这保持了通知“发送后无需理会”的特性,同时允许异步通信中的竞争条件。