【MCP协议】取消通知

105 阅读1分钟

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

取消流程

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

  • 待取消请求的ID
  • 可选的取消原因字符串(用于记录或显示)

示例:

{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "123",
    "reason": "用户请求取消"
  }
}

行为规范要求

  1. 取消通知必须仅引用符合以下条件的请求:
  • 先前由同一方向发起的请求
  • 当前仍被认为处于处理中的请求
  1. 初始化请求(initialize)不得被客户端取消
  2. 接收方收到取消通知后应当:
  • 停止处理被取消的请求
  • 释放相关资源
  • 不再发送被取消请求的响应
  1. 在以下情况下接收方可以忽略取消通知:
  • 引用的请求不存在
  • 请求处理已完成
  • 该请求不可被取消
  1. 取消通知的发送方应当忽略请求被取消后到达的任何响应

时序考量

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

双方必须妥善处理这类竞态条件:

mcp_cancel.png

实现说明

  • 双方应记录取消原因以便调试
  • 应用界面应显示取消请求状态

错误处理

应忽略无效的取消通知:

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

这保持了通知"发送即忘"的特性,同时兼容异步通信中的竞态条件。