Skip to main content
模型上下文协议(MCP协议)中的传输为客户端和服务器之间的通信提供了基础。传输负责处理消息发送和接收的底层机制。

消息格式

MCP 使用 JSON-RPC 2.0 作为其传输格式。传输层负责将 MCP 协议消息转换为 JSON-RPC 格式进行传输,并将接收到的 JSON-RPC 消息转换回 MCP 协议消息。 使用了三种类型的 JSON-RPC 消息:

请求

响应

通知

内置传输类型

MCP 包含两种标准传输实现:

标准输入/输出(stdio)

stdio 传输通过标准输入和输出流实现通信。这对于本地集成和命令行工具特别有用。 使用 stdio 的场景:
  • 构建命令行工具
  • 实现本地集成
  • 需要简单的进程通信
  • 使用 shell 脚本

服务器发送事件(SSE)

SSE 传输通过 HTTP POST 请求实现服务器到客户端的流式通信。 使用 SSE 的场景:
  • 仅需要服务器到客户端的流式通信
  • 在受限网络中工作
  • 实现简单的更新

自定义传输

MCP 使得为特定需求实现自定义传输变得容易。任何传输实现只需符合传输接口即可: 您可以实现自定义传输的场景:
  • 自定义网络协议
  • 专用通信通道
  • 与现有系统集成
  • 性能优化

错误处理

传输实现应处理各种错误场景:
  1. 连接错误
  2. 消息解析错误
  3. 协议错误
  4. 网络超时
  5. 资源清理
错误处理示例:

最佳实践

在实现或使用 MCP 传输时:
  1. 正确处理连接生命周期
  2. 实现适当的错误处理
  3. 在连接关闭时清理资源
  4. 使用适当的超时
  5. 在发送前验证消息
  6. 记录传输事件以便调试
  7. 在适当的情况下实现重连逻辑
  8. 处理消息队列中的背压
  9. 监控连接健康状态
  10. 实施适当的安全措施

安全注意事项

在实现传输时:

认证与授权

  • 实施适当的认证机制
  • 验证客户端凭据
  • 使用安全的令牌处理
  • 实施授权检查

数据安全

  • 使用 TLS 进行网络传输
  • 加密敏感数据
  • 验证消息完整性
  • 实施消息大小限制
  • 清理输入数据

网络安全

  • 实施速率限制
  • 使用适当的超时
  • 处理拒绝服务场景
  • 监控异常模式
  • 实施适当的防火墙规则

调试传输

调试传输问题的技巧:
  1. 启用调试日志
  2. 监控消息流
  3. 检查连接状态
  4. 验证消息格式
  5. 测试错误场景
  6. 使用网络分析工具
  7. 实施健康检查
  8. 监控资源使用情况
  9. 测试边缘情况
  10. 使用适当的错误跟踪