传输
ℹ️
协议版本: 2024-11-05
MCP 目前定义了两种标准传输机制用于客户端-服务器通信:
- stdio,通过标准输入和标准输出进行通信
- 带有服务器发送事件的 HTTP (SSE)
客户端应该尽可能支持 stdio。
客户端和服务器也可以以可插拔的方式实现自定义传输。
stdio
在 stdio 传输中:
- 客户端将 MCP 服务器启动为子进程。
- 服务器在其标准输入(
stdin
)上接收 JSON-RPC 消息,并将响应写入其标准输出(stdout
)。 - 消息由换行符分隔,并且不得包含嵌入的换行符。
- 服务器可以为日志记录目的向其标准错误(
stderr
)写入 UTF-8 字符串。客户端可以捕获、转发或忽略此日志记录。 - 服务器不得向其
stdout
写入任何不是有效 MCP 消息的内容。 - 客户端不得向服务器的
stdin
写入任何不是有效 MCP 消息的内容。
HTTP with SSE
在 SSE 传输中,服务器作为独立进程运行,可以处理多个客户端连接。
服务器必须提供两个端点:
- 一个 SSE 端点,供客户端建立连接并接收来自服务器的消息
- 一个常规的 HTTP POST 端点,供客户端向服务器发送消息
当客户端连接时,服务器必须发送一个包含 URI 的 endpoint
事件,客户端用于发送消息。所有后续客户端消息必须作为 HTTP POST 请求发送到此端点。
服务器消息作为 SSE message
事件发送,消息内容在事件数据中编码为 JSON。
自定义传输
客户端和服务器可以实现额外的自定义传输机制以满足其特定需求。协议是传输不可知的,可以在支持双向消息交换的任何通信通道上实现。
选择支持自定义传输的实现者必须确保它们保留 MCP 定义的 JSON-RPC 消息格式和生命周期要求。自定义传输应该记录其特定的连接建立和消息交换模式,以帮助互操作性。