传输

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

1. stdio，通过标准输入和标准输出进行通信
2. HTTP 与服务器发送事件 (SSE)

客户端 应 尽可能支持 stdio。

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

stdio

在 stdio 传输中：

• 客户端将 MCP 服务器作为子进程启动。
• 服务器在其标准输入 (stdin) 上接收 JSON-RPC 消息，并将其响应写入标准输出 (stdout)。
• 消息由换行符分隔，并且 不得 包含嵌入的换行符。
• 服务器 可以 将其标准错误 (stderr) 写入 UTF-8 字符串以用于日志记录。客户端 可以 捕获、转发或忽略此日志记录。
• 服务器 不得 在其 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 与 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 message 事件
    end
    Client->>Server: 关闭 SSE 连接

自定义传输

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

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