取消机制

• 1. 取消流程
• 2. 行为要求
• 3. 时序考虑
• 4. 实现注意事项
• 5. 错误处理

协议修订版本：2025-06-18

Model Context Protocol (MCP) 通过通知消息支持可选的进行中请求取消功能。任何一方都可以发送取消通知来指示先前发出的请求应该被终止。

1. 取消流程

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

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

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

2. 行为要求

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

3. 时序考虑

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

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

4. 实现注意事项

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

5. 错误处理

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

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

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