模型上下文协议(MCP)支持通过通知消息取消进行中的请求。任何一方均可发送取消通知,表明应终止先前发出的请求。
取消流程
当一方需要取消进行中的请求时,应发送包含以下内容的 notifications/cancelled 通知:
- 待取消请求的ID
- 可选的取消原因字符串(用于记录或显示)
示例:
{
"jsonrpc": "2.0",
"method": "notifications/cancelled",
"params": {
"requestId": "123",
"reason": "用户请求取消"
}
}
行为规范要求
- 取消通知必须仅引用符合以下条件的请求:
- 先前由同一方向发起的请求
- 当前仍被认为处于处理中的请求
- 初始化请求(initialize)不得被客户端取消
- 接收方收到取消通知后应当:
- 停止处理被取消的请求
- 释放相关资源
- 不再发送被取消请求的响应
- 在以下情况下接收方可以忽略取消通知:
- 引用的请求不存在
- 请求处理已完成
- 该请求不可被取消
- 取消通知的发送方应当忽略请求被取消后到达的任何响应
时序考量
由于网络延迟,取消通知可能在请求处理完成后才到达,甚至可能在响应已经发送后才被接收。
双方必须妥善处理这类竞态条件:
实现说明
- 双方应记录取消原因以便调试
- 应用界面应显示取消请求状态
错误处理
应忽略无效的取消通知:
- 未知请求ID
- 已完成的请求
- 格式错误的通知
这保持了通知"发送即忘"的特性,同时兼容异步通信中的竞态条件。