取消

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. 取消通知的发送方应该忽略之后到达的任何请求响应

时序考虑

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

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

Server Client Server Client Processing starts Processing may have completed before cancellation arrives Stop processing alt [If not completed] Request (ID: 123)notifications/cancelled (ID: 123)

实现说明

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

错误处理

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

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

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