取消 - Model Context Protocol 中文文档

Model Context Protocol (MCP) 支持通过通知消息对进行中的请求进行可选取消。任一方都可以发送取消通知，表示应终止先前发出的请求。

取消流程

当一方想要取消进行中的请求时，会发送 notifications/cancelled 通知，其中包含：

{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "123",
    "reason": "User requested cancellation"
  }
}

客户端如何发出取消信号取决于传输：

Streamable HTTP：关闭 SSE 响应流就是取消信号。服务器 MUST 将客户端断开连接视为取消该请求。不需要也不期望 notifications/cancelled 消息。
stdio：没有可关闭的按请求流。客户端 MUST 发送引用请求 ID 的 notifications/cancelled 通知。

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

无效的取消通知 SHOULD 被忽略：

这保持了通知“发后即忘”的性质，同时允许异步通信中出现竞态条件。