Ping - Model Context Protocol 中文文档

Model Context Protocol 包含一种可选的 ping 机制，允许任一方验证对端仍有响应且连接仍然存活。

概览

ping 功能通过简单的请求/响应模式实现。客户端或服务器都可以通过发送 ping 请求来发起 ping。

消息格式

ping 请求是一个不带参数的标准 JSON-RPC 请求：

{
  "jsonrpc": "2.0",
  "id": "123",
  "method": "ping"
}

行为要求

接收方 MUST 及时以空响应进行响应：

{
  "jsonrpc": "2.0",
  "id": "123",
  "result": {}
}

如果在合理超时时间内未收到响应，发送方 MAY：
- 认为连接已失效
- 终止连接
- 尝试重新连接流程

使用模式

实现考量

实现 SHOULD 定期发出 ping，以检测连接健康状况
ping 频率 SHOULD 可配置
超时时间 SHOULD 适合网络环境
SHOULD 避免过度 ping，以减少网络开销

错误处理

超时 SHOULD 被视为连接失败
多次 ping 失败 MAY 触发连接重置
实现 SHOULD 记录 ping 失败以便诊断