协议修订: 2025-06-18
模型上下文协议 (MCP) 支持通过通知消息来可选地取消正在进行中的请求。任何一方都可以发送取消通知,以表明应终止先前发出的请求。

取消流程

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

行为要求

  1. 取消通知**必须**仅引用满足以下条件的请求:
    • 先前在同一方向上发出
    • 被认为仍在进行中
  2. 客户端**不得**取消 initialize 请求
  3. 取消通知的接收方**应该 (SHOULD)**:
    • 停止处理被取消的请求
    • 释放相关资源
    • 不为被取消的请求发送响应
  4. 在以下情况下,接收方**可以 (MAY)** 忽略取消通知:
    • 引用的请求未知
    • 处理已完成
    • 该请求无法被取消
  5. 取消通知的发送方**应该 (SHOULD)** 忽略之后收到的任何对该请求的响应

时间考量

由于网络延迟,取消通知可能在请求处理完成之后、甚至可能在响应已发送之后才到达。 双方**必须**妥善处理这些竞态条件:

实现说明

  • 双方**应该 (SHOULD)** 记录取消原因以供调试
  • 应用程序用户界面**应该 (SHOULD)** 在请求取消时给予提示

错误处理

无效的取消通知**应该 (SHOULD)** 被忽略
  • 未知的请求 ID
  • 已完成的请求
  • 格式错误的通知
这在允许异步通信中出现竞态条件的同时,保持了通知“即发即弃”的特性。