传输 Transports

了解 MCP 的通信机制

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

消息格式

MCP 使用 JSON-RPC 2.0 作为其线路格式。传输层负责将 MCP 协议消息转换为 JSON-RPC 格式以进行传输，并将接收到的 JSON-RPC 消息转换回 MCP 协议消息。

使用三种类型的 JSON-RPC 消息：

请求

响应

通知

内置传输类型

MCP 包括两个标准传输(Transport)实现：

标准输入/输出 (stdio)

stdio 传输(transport)能够通过标准输入和输出流进行通信。这对于本地集成和命令行工具特别有用。

在以下情况下使用 stdio：

构建命令行工具

实现本地集成

需要简单的进程通信

使用 shell 脚本

TypeScript

服务器发送事件 (SSE)

SSE 传输(transport)支持服务器到客户端的流式传输，并使用 HTTP POST 请求进行客户端到服务器的通信。

在以下情况下使用 SSE：

只需要服务器到客户端的流式传输

使用受限网络

实现简单的更新

TypeScript

自定义传输

MCP 可以轻松地为特定需求实现自定义传输(transport)。任何传输(transport)实现只需要符合 Transport 接口：

您可以为以下情况实现自定义传输：

自定义网络协议

专用通信通道

与现有系统集成

性能优化

TypeScript

Python

请注意，虽然 MCP 服务器通常使用 asyncio 实现，但我们建议使用 anyio 实现传输等底层接口，以获得更广泛的兼容性。

错误处理

传输(Transport)实现应处理各种错误情况：

连接错误

消息解析错误

协议错误

网络超时

资源清理

错误处理示例：

TypeScript

Python

请注意，虽然 MCP 服务器通常使用 asyncio 实现，但我们建议使用 anyio 实现传输等底层接口，以获得更广泛的兼容性。

最佳实践

在实现或使用 MCP 传输(transport)时：

正确处理连接生命周期

实施适当的错误处理

在连接关闭时清理资源

使用适当的超时

在发送之前验证消息

记录传输事件以进行调试

在适当时实现重新连接逻辑

处理消息队列中的背压(backpressure)

监控连接健康状况

10.

实施适当的安全措施

安全注意事项

在实现传输(transport)时：

身份验证和授权

实施适当的身份验证机制

验证客户端凭据

使用安全令牌处理

实施授权检查

数据安全

对网络传输使用 TLS

加密敏感数据

验证消息完整性

实施消息大小限制

过滤输入数据

网络安全

实施速率限制

使用适当的超时

处理拒绝服务(denial of service)场景

监控异常模式

实施适当的防火墙规则

调试传输

调试传输问题的提示：

启用调试日志

监控消息流

检查连接状态

验证消息格式

测试错误场景

使用网络分析工具

实施健康检查

监控资源使用情况

测试边缘情况

10.

使用适当的错误跟踪

了解 MCP 的通信机制#

了解 MCP 的通信机制