跳过主要内容
模型上下文协议 (MCP) 支持两种主要的传输机制用于 Cline 和 MCP 服务器之间的通信:标准输入/输出 (STDIO) 和服务器发送事件 (SSE)。每种机制都有其独特的特性、优势和用例。

STDIO 传输

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

STDIO 传输如何工作

  1. 客户端 (Cline) 将 MCP 服务器作为子进程启动
  2. 通信通过进程流进行:客户端写入服务器的 STDIN,服务器响应到 STDOUT
  3. 每条消息由换行符分隔
  4. 消息格式为 JSON-RPC 2.0
Client                    Server
  |                         |
  |<---- JSON message ----->| (via STDIN)
  |                         | (processes request)
  |<---- JSON message ------| (via STDOUT)
  |                         |

STDIO 特性

  • 本地性:与 Cline 在同一台机器上运行
  • 性能:极低的延迟和开销(不涉及网络堆栈)
  • 简单性:直接进程通信,无需网络配置
  • 关系:客户端和服务器之间的一对一关系
  • 安全性:固有地更安全,因为没有网络暴露

何时使用 STDIO

STDIO 传输非常适合
  • 在同一台机器上运行的本地集成和工具
  • 对安全性敏感的操作
  • 低延迟要求
  • 单客户端场景(每个服务器一个 Cline 实例)
  • 命令行工具或 IDE 扩展

STDIO 实现示例

import { Server } from "@modelcontextprotocol/sdk/server/index.js"
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"

const server = new Server({ name: "local-server", version: "1.0.0" })
// Register tools...

// Use STDIO transport
const transport = new StdioServerTransport(server)
transport.listen()

SSE 传输

服务器发送事件 (SSE) 传输在远程服务器上运行,并通过 HTTP/HTTPS 进行通信。

SSE 传输如何工作

  1. 客户端 (Cline) 通过 HTTP GET 请求连接到服务器的 SSE 端点
  2. 这建立了一个持久连接,服务器可以通过该连接向客户端推送事件
  3. 对于客户端到服务器的通信,客户端向单独的端点发出 HTTP POST 请求
  4. 通信通过两个通道进行
    • 事件流 (GET):服务器到客户端更新
    • 消息端点 (POST):客户端到服务器请求
Client                             Server
  |                                  |
  |---- HTTP GET /events ----------->| (establish SSE connection)
  |<---- SSE event stream -----------| (persistent connection)
  |                                  |
  |---- HTTP POST /message --------->| (client request)
  |<---- SSE event with response ----| (server response)
  |                                  |

SSE 特性

  • 远程访问:可以托管在与您的 Cline 实例不同的机器上
  • 可扩展性:可以同时处理多个客户端连接
  • 协议:通过标准 HTTP 工作(不需要特殊协议)
  • 持久性:保持服务器到客户端消息的持久连接
  • 身份验证:可以使用标准的 HTTP 身份验证机制

何时使用 SSE

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

SSE 实现示例

import { Server } from "@modelcontextprotocol/sdk/server/index.js"
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js"
import express from "express"

const app = express()
const server = new Server({ name: "remote-server", version: "1.0.0" })
// Register tools...

// Use SSE transport
const transport = new SSEServerTransport(server)
app.use("/mcp", transport.requestHandler())
app.listen(3000, () => {
	console.log("MCP server listening on port 3000")
})

本地 vs. 托管:部署方面

STDIO 和 SSE 传输之间的选择直接影响您部署和管理 MCP 服务器的方式。

STDIO:本地部署模型

STDIO 服务器在与 Cline 相同的机器上本地运行,这有几个重要的影响
  • 安装:服务器可执行文件必须安装在每个用户的机器上
  • 分发:您需要为不同的操作系统提供安装包
  • 更新:每个实例必须单独更新
  • 资源:使用本地机器的 CPU、内存和磁盘
  • 访问控制:依赖于本地机器的文件系统权限
  • 集成:易于与本地系统资源(文件、进程)集成
  • 执行:随 Cline 启动和停止(子进程生命周期)
  • 依赖项:任何依赖项都必须安装在用户的机器上

实际示例

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

SSE:托管部署模型

SSE 服务器可以部署到远程服务器并通过网络访问
  • 安装:在服务器上安装一次,由许多用户访问
  • 分发:单次部署服务多个客户端
  • 更新:集中式更新立即影响所有用户
  • 资源:使用服务器资源,而不是本地机器资源
  • 访问控制:通过身份验证和授权系统进行管理
  • 集成:与特定用户资源的集成更复杂
  • 执行:作为独立服务运行(通常持续运行)
  • 依赖项:在服务器上管理,而不是在用户机器上管理

实际示例

使用 SSE 的数据库查询工具将
  • 在中央服务器上运行
  • 使用服务器端凭据连接到数据库
  • 持续为多个用户提供服务
  • 需要适当的网络安全配置
  • 使用容器或云技术部署

混合方法

某些场景受益于混合方法
  1. 带网络访问的 STDIO:充当远程服务代理的本地 STDIO 服务器
  2. 带本地命令的 SSE:可以通过回调在客户端机器上触发操作的远程 SSE 服务器
  3. 网关模式:用于本地操作的 STDIO 服务器连接到用于专门功能的 SSE 服务器

在 STDIO 和 SSE 之间选择

考虑因素STDIOSSE
位置仅限本地机器本地或远程
客户端单个客户端多个客户端
性能较低延迟较高延迟(网络开销)
设置复杂性更简单更复杂(需要 HTTP 服务器)
安全性固有安全需要明确的安全措施
网络访问不需要需要
可扩展性限于本地机器可跨网络分发
部署按用户安装集中安装
更新分布式更新集中更新
资源使用使用客户端资源使用服务器资源
依赖项客户端依赖项服务器端依赖项

在 Cline 中配置传输

有关在 Cline 中配置 STDIO 和 SSE 传输的详细信息,包括示例,请参阅配置 MCP 服务器