Ping 机制

• 1. 概述
• 2. 消息格式
• 3. 行为要求
• 4. 使用模式
• 5. 实现注意事项
• 6. 错误处理

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

Model Context Protocol 包含一个可选的 ping 机制，允许任一方验证其对端是否仍然响应且连接处于活跃状态。

1. 概述

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

2. 消息格式

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

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

3. 行为要求

1. 接收方必须及时响应一个空响应：

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

2. 如果在合理的超时时间内未收到响应，发送方可以：
   • 认为连接已失效
   • 终止连接
   • 尝试重连程序

4. 使用模式

5. 实现注意事项

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

6. 错误处理

• 超时应该被视为连接失败
• 多次 ping 失败可以触发连接重置
• 实现应该记录 ping 失败以用于诊断