概述

MCP 提供三种传输选项，每种都适合不同的部署场景：

STDIO 传输（本地服务器）
Streamable HTTP 传输（远程服务器的现代标准）
SSE 传输（旧版远程选项）

每种传输都有不同的特征、优势和用例。

STDIO 传输

STDIO 传输在您的机器上本地运行，并通过标准输入/输出流进行通信。

STDIO 传输的工作原理

Bob 将 MCP 服务器作为子进程生成
通信通过进程流进行：Bob 写入服务器的 STDIN，服务器响应 STDOUT
每条消息由换行符分隔
消息格式化为 JSON-RPC 2.0

客户端                    服务器
  |                         |
  |---- JSON 消息 ------>| (通过 STDIN)
  |                         | (处理请求)
  |<---- JSON 消息 ------| (通过 STDOUT)
  |                         |

STDIO 特征

本地性：在与 Bob 相同的机器上运行
性能：非常低的延迟和开销（不涉及网络堆栈）
简单性：无需网络配置的直接进程通信
关系：客户端和服务器之间的一对一关系
安全性：由于没有网络暴露，因此本质上更安全

何时使用 STDIO

STDIO 传输非常适合：

在同一台机器上运行的本地集成和工具
安全敏感操作
低延迟要求
单客户端场景（每个服务器一个 Bob 实例）
命令行工具或 IDE 扩展

STDIO 实现示例


const server = new Server({name: 'local-server', version: '1.0.0'});
// 注册工具...

// 使用 STDIO 传输
const transport = new StdioServerTransport(server);
transport.listen();

Streamable HTTP 传输

Streamable HTTP 传输是远程 MCP 服务器通信的现代标准，取代了较旧的 HTTP+SSE 传输。它通过 HTTP/HTTPS 运行，并允许更灵活的服务器实现。

Streamable HTTP 传输的工作原理

服务器提供一个支持 POST 和 GET 方法的单个 HTTP 端点（MCP 端点）
Bob 使用 HTTP POST 向此 MCP 端点发送请求
服务器处理请求并发送回响应
可选地，服务器可以使用服务器发送事件（SSE）通过同一连接向 Bob 流式传输多条消息或通知

这允许基本的请求-响应交互以及更高级的流式传输和服务器发起的通信。

客户端                             服务器
  |                                  |
  |---- HTTP POST /mcp_endpoint ---->| (客户端请求)
  |                                  | (处理请求)
  |<--- HTTP 响应 / SSE 流 --| (服务器响应 / 流)
  |                                  |

Streamable HTTP 特征

现代标准：新远程 MCP 服务器实现的首选方法
远程访问：可以托管在与 Bob 不同的机器上
可扩展性：可以同时处理多个客户端连接
协议：通过标准 HTTP/HTTPS 工作
灵活性：支持简单的请求-响应和高级流式传输
单个端点：对所有 MCP 通信使用单个 URL 路径
身份验证：可以使用标准 HTTP 身份验证机制
向后兼容性：服务器可以保持与较旧的 HTTP+SSE 客户端的兼容性

何时使用 Streamable HTTP

Streamable HTTP 传输非常适合：

所有新的远程 MCP 服务器开发
需要强大、可扩展和灵活通信的服务器
可能涉及流式数据或服务器发送通知的集成
公共服务或集中式工具
替换旧版 SSE 传输实现

Streamable HTTP 实现示例

settings.json 中的配置：

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

有关服务器端实现，请参阅 MCP SDK 文档中的 StreamableHTTPClientTransport。

与 HTTP+SSE 的向后兼容性

客户端和服务器可以保持与已弃用的 HTTP+SSE 传输的向后兼容性。

希望支持较旧客户端的服务器应继续托管旧传输的 SSE（/events）和 POST（/message）端点，以及为 Streamable HTTP 传输定义的新 MCP 端点。

SSE 传输（旧版）

服务器发送事件（SSE）传输在远程服务器上运行，并通过 HTTP/HTTPS 进行通信。对于新的远程服务器，请改用 Streamable HTTP 传输。

SSE 传输的工作原理

Bob 通过 HTTP GET 请求连接到服务器的 SSE 端点
这建立了一个持久连接，服务器可以向 Bob 推送事件
对于客户端到服务器的通信，Bob 向单独的端点发出 HTTP POST 请求
通信通过两个通道进行：
- 事件流（GET）：服务器到客户端更新
- 消息端点（POST）：客户端到服务器请求

客户端                             服务器
  |                                  |
  |---- HTTP GET /events ----------->| (建立 SSE 连接)
  |<---- SSE 事件流 -----------| (持久连接)
  |                                  |
  |---- HTTP POST /message --------->| (客户端请求)
  |<---- 带响应的 SSE 事件 ----| (服务器响应)
  |                                  |

SSE 特征

远程访问：可以托管在与 Bob 不同的机器上
可扩展性：可以同时处理多个客户端连接
协议：通过标准 HTTP 工作（不需要特殊协议）
持久性：为服务器到客户端消息维护持久连接
身份验证：可以使用标准 HTTP 身份验证机制

何时使用 SSE

SSE 传输适用于：

跨网络的远程访问
多客户端场景
公共服务
许多用户需要访问的集中式工具
与 Web 服务集成

SSE 实现示例

import express from 'express';

const app = express();
const server = new Server({name: 'remote-server', version: '1.0.0'});
// 注册工具...

// 使用 SSE 传输
const transport = new SSEServerTransport(server);
app.use('/mcp', transport.requestHandler());
app.listen(3000, () => {
  console.log('MCP 服务器在端口 3000 上监听');
});

部署注意事项

STDIO 和远程传输（Streamable HTTP 或 SSE）之间的选择直接影响您如何部署和管理 MCP 服务器。

STDIO：本地部署

STDIO 服务器在与 Bob 相同的机器上本地运行：

安装：服务器可执行文件必须安装在每个用户的机器上
分发：您需要为不同的操作系统提供安装包
更新：每个实例必须单独更新
资源：使用本地机器的 CPU、内存和磁盘
访问控制：依赖于本地机器的文件系统权限
集成：与本地系统资源（文件、进程）轻松集成
执行：随 Bob 启动和停止（子进程生命周期）
依赖项：任何依赖项都必须安装在用户的机器上

示例用例：

使用 STDIO 的本地文件搜索工具将：

在用户的机器上运行
直接访问本地文件系统
在 Bob 需要时启动
不需要网络配置
需要与 Bob 一起安装或通过包管理器安装

远程：托管部署

远程服务器（Streamable HTTP 或 SSE）可以部署到远程服务器并通过网络访问：

安装：在服务器上安装一次，由许多用户访问
分发：单个部署为多个客户端提供服务
更新：集中更新立即影响所有用户
资源：使用服务器资源，而不是本地机器资源
访问控制：通过身份验证和授权系统管理
集成：与用户特定资源的集成更复杂
执行：作为独立服务运行（通常持续运行）
依赖项：在服务器上管理，而不是在用户机器上