传输

MCP 目前定义了两种用于客户端-服务器通信的标准传输机制：

1. stdio，通过标准输入和标准输出进行通信
2. HTTP with Server-Sent Events (SSE)

客户端 应 尽可能支持 stdio。

客户端和服务器也可以以可插拔的方式实现 自定义传输。

stdio

在 stdio 传输中：

• 客户端将 MCP 服务器作为子进程启动。
• 服务器在其标准输入 (stdin) 上接收 JSON-RPC 消息，并将响应写入其标准输出 (stdout)。
• 消息以换行符分隔，不得 包含嵌入的换行符。
• 服务器 可以 将 UTF-8 字符串写入其标准错误 (stderr) 进行日志记录。客户端 可以 捕获、转发或忽略此日志记录。
• 服务器 不得 向其 stdout 写入任何不是有效 MCP 消息的内容。
• 客户端 不得 向服务器的 stdin 写入任何不是有效 MCP 消息的内容。

sequenceDiagram
    participant Client
    participant Server Process

    Client->>+Server Process: 启动子进程
    loop 消息交换
        Client->>Server Process: 写入 stdin
        Server Process->>Client: 写入 stdout
        Server Process--)Client: 可选的 stderr 日志
    end
    Client->>Server Process: 关闭 stdin，终止子进程
    deactivate Server Process

HTTP with SSE

在 SSE 传输中，服务器作为独立进程运行，可以处理多个客户端连接。

服务器 必须 提供两个端点：

1. 一个 SSE 端点，供客户端建立连接并接收来自服务器的消息
2. 一个常规的 HTTP POST 端点，供客户端向服务器发送消息

当客户端连接时，服务器 必须 发送一个 endpoint 事件，其中包含一个 URI，供客户端用于发送消息。所有后续的客户端消息 必须 作为 HTTP POST 请求发送到此端点。

服务器消息作为 SSE message 事件发送，消息内容以 JSON 编码在事件数据中。

sequenceDiagram
    participant Client
    participant Server

    Client->>Server: 打开 SSE 连接
    Server->>Client: endpoint 事件
    loop 消息交换
        Client->>Server: HTTP POST 消息
        Server->>Client: SSE 消息事件
    end
    Client->>Server: 关闭 SSE 连接

自定义传输

客户端和服务器 可以 实现其他自定义传输机制，以满足其特定需求。该协议是传输无关的，可以在任何支持双向消息交换的通信通道上实现。

选择支持自定义传输的实现者 必须 确保它们保留 MCP 定义的 JSON-RPC 消息格式和生命周期要求。自定义传输 应 记录其特定的连接建立和消息交换模式，以帮助互操作性。