Search Docs
模型上下文协议(MCP)通过通知消息支持对长时间运行操作的可选进度跟踪。任一方均可发送进度通知,以提供操作状态的更新。
当一方希望为请求 接收 进度更新时,它会在请求元数据中包含一个 progressToken。
progressToken
{ "jsonrpc": "2.0", "id": 1, "method": "some_method", "params": { "_meta": { "progressToken": "abc123" } } }
接收方 可以 发送包含以下内容的进度通知:
{ "jsonrpc": "2.0", "method": "notifications/progress", "params": { "progressToken": "abc123", "progress": 50, "total": 100 } }
progress
total
进度通知 必须 仅引用满足以下条件的令牌:
接收进度请求的一方 可以:
sequenceDiagram participant Sender participant Receiver Note over Sender,Receiver: 带进度令牌的请求 Sender->>Receiver: 带 progressToken 的方法请求 Note over Sender,Receiver: 进度更新 loop 进度更新 Receiver-->>Sender: 进度通知 (0.2/1.0) Receiver-->>Sender: 进度通知 (0.6/1.0) Receiver-->>Sender: 进度通知 (1.0/1.0) end Note over Sender,Receiver: 操作完成 Receiver->>Sender: 方法响应