Skip to main content

MCP 传输机制

模型上下文协议（MCP）支持 Careti 和 MCP 服务器之间通信的两种主要传输机制：标准输入/输出（STDIO）和服务器发送事件（SSE）。每种都有独特的特性、优势和用例。

STDIO 传输​

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

STDIO 传输的工作原理​

  1. 客户端（Careti）将 MCP 服务器作为子进程生成
  2. 通信通过进程流进行：客户端写入服务器的 STDIN，服务器响应到 STDOUT
  3. 每条消息由换行符分隔
  4. 消息格式为 JSON-RPC 2.0
客户端                    服务器
  |                         |
  |<---- JSON 消息 -------->| (通过 STDIN)
  |                         | (处理请求)
  |<---- JSON 消息 ---------| (通过 STDOUT)
  |                         |

STDIO 特性​

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

何时使用 STDIO​

STDIO 传输适用于：

  • 在同一台计算机上运行的本地集成和工具
  • 安全敏感操作
  • 低延迟要求
  • 单客户端场景（每个服务器一个 Careti 实例）
  • 命令行工具或 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" })
// 注册工具...

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

SSE 传输​

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

SSE 传输的工作原理​

  1. 客户端（Careti）通过 HTTP GET 请求连接到服务器的 SSE 端点
  2. 这建立了一个持久连接，服务器可以向客户端推送事件
  3. 对于客户端到服务器的通信，客户端向单独的端点发出 HTTP POST 请求
  4. 通信通过两个通道进行：
    • 事件流（GET）：服务器到客户端的更新
    • 消息端点（POST）：客户端到服务器的请求
客户端                             服务器
  |                                  |
  |---- HTTP GET /events ----------->| (建立 SSE 连接)
  |<---- SSE 事件流 ------------------| (持久连接)
  |                                  |
  |---- HTTP POST /message --------->| (客户端请求)
  |<---- 带响应的 SSE 事件 -----------| (服务器响应)
  |                                  |

SSE 特性​

  • 远程访问：可以托管在与 Careti 实例不同的计算机上
  • 可扩展性：可以同时处理多个客户端连接
  • 协议：通过标准 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" })
// 注册工具...

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

本地与托管：部署方面​

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

STDIO：本地部署模型​

STDIO 服务器在与 Careti 相同的计算机上本地运行，这有几个重要影响：

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

实际示例​

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

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

SSE：托管部署模型​

SSE 服务器可以部署到远程服务器并通过网络访问：

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

实际示例​

使用 SSE 的数据库查询工具将：

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

混合方法​

某些场景受益于混合方法：

  1. 带网络访问的 STDIO：充当远程服务代理的本地 STDIO 服务器
  2. 带本地命令的 SSE：可以通过回调在客户端计算机上触发操作的远程 SSE 服务器
  3. 网关模式：用于本地操作的 STDIO 服务器连接到 SSE 服务器以获得专门功能

在 STDIO 和 SSE 之间选择​

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

在 Careti 中配置传输​

有关在 Careti 中配置 STDIO 和 SSE 传输的详细信息（包括示例），请参阅 配置 MCP 服务器。