IBM Bob

MCP 服务器传输方式

MCP 支持多种传输机制，用于 Bob Shell 与 MCP 服务器之间的通信。

概述

MCP 提供三种传输选项，分别适用于不同的部署场景：

每种传输方式都有各自的特性、优势和使用场景。

STDIO 传输

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

STDIO 传输的工作原理

  1. Bob 以子进程形式启动 MCP 服务器
    2.
  2. 通信通过进程流进行：Bob 向服务器的 STDIN 写入数据，服务器通过 STDOUT 响应
    3.
  3. 每条消息以换行符分隔
    4.
  4. 消息格式为 JSON-RPC 2.0
    5.  
客户端                    服务器
  |                         |
  |---- JSON 消息 -------->| （通过 STDIN）
  |                         | （处理请求）
  |<---- JSON 消息 ---------| （通过 STDOUT）
  |                         |

STDIO 传输特性

  • 本地性：与 Bob 运行在同一台机器上
    •
  • 性能：延迟极低，开销极小（无网络栈）
    •
  • 简单性：直接进程通信，无需网络配置
    •
  • 关系：客户端与服务器一对一关系
    •
  • 安全性：无网络暴露，本质上更安全
    •

何时使用 STDIO

STDIO 传输适合以下场景：
  • 在同一台机器上运行的本地集成和工具
    •
  • 安全敏感操作
    •
  • 低延迟需求
    •
  • 单客户端场景（每个服务器对应一个 Bob 实例）
    •
  • 命令行工具和脚本
    •

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 传输的工作原理

  1. 服务器提供单一 HTTP 端点（MCP 端点），同时支持 POST 和 GET 方法
    2.
  2. Bob 使用 HTTP POST 向该 MCP 端点发送请求
    3.
  3. 服务器处理请求并返回响应
    4.
  4. 可选地，服务器可以通过同一连接使用 Server-Sent Events（SSE）向 Bob 流式传输多条消息或通知
    5.

这既支持基本的请求-响应交互，也支持更高级的流式传输和服务器主动通信。

 
客户端                             服务器
  |                                  |
  |---- 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 实现示例

在 ~/.bob/settings/mcp.json（全局）或 .bob/mcp.json（项目）中进行配置：

 
{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "httpURL": "http://localhost:8080/mcp"
    }
  }
}

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

与 HTTP+SSE 的向后兼容性

Bob 的 MCP 客户端不会回退到 HTTP+SSE 传输。以下说明适用于希望其 Streamable HTTP 服务器对尚不支持 Streamable HTTP 的旧版客户端保持可用的_服务器作者_。

需要支持旧版客户端的服务器应继续托管旧传输的 SSE（/events）和 POST（/message）端点，同时提供为 Streamable HTTP 传输定义的新 MCP 端点。

SSE 传输（已移除）

Bob 的 MCP 客户端不再支持独立的 HTTP+SSE 传输（MCP 规范 2024-11-05）。仅使用 HTTP+SSE 传输的服务器无法连接到 Bob。
注意：

SSE 作为 Streamable HTTP 连接中的响应通道仍受支持。Bob 可以从 Streamable HTTP 服务器接收 SSE 流。仅独立的 HTTP+SSE 传输（具有独立的 /events 和 /message 端点）已被移除。

从 SSE 传输迁移

如果你有使用 HTTP+SSE 传输的现有服务器，请将其迁移到 Streamable HTTP 传输或 STDIO 传输：
  • Streamable HTTP：提供一个接受 HTTP POST 请求的单一 MCP 端点。这是远程服务器的推荐路径。请参阅 Streamable HTTP 传输。
    •
  • STDIO：如果服务器在与 Bob 相同的机器上本地运行，请将其转换为 STDIO 服务器。请参阅 STDIO 传输。
    •

部署注意事项

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

STDIO：本地部署

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

使用场景示例：

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

远程：托管部署

远程服务器（Streamable HTTP）可以部署到远程服务器并通过网络访问：
  • 安装：在服务器上安装一次，多个用户访问
    •
  • 分发：单次部署服务多个客户端
    •
  • 更新：集中更新立即影响所有用户
    •
  • 资源：使用服务器资源，而非本地机器资源
    •
  • 访问控制：通过认证和授权系统管理
    •
  • 集成：与用户特定资源的集成更为复杂
    •
  • 执行：作为独立服务运行（通常持续运行）
    •
  • 依赖：在服务器上管理，而非用户机器上
    •

使用场景示例：

使用远程传输的数据库查询工具：
  • 在中央服务器上运行
    •
  • 使用服务器端凭据连接数据库
    •
  • 持续可用，服务多个用户
    •
  • 需要适当的网络安全配置
    •
  • 使用容器或云技术部署
    •

混合方式

某些场景受益于混合方式：
  1. 具有网络访问能力的 STDIO：充当远程服务代理的本地 STDIO 服务器
    2.
  2. 具有本地命令的远程：通过回调在客户端机器上触发操作的远程服务器
    3.
  3. 网关模式：用于本地操作的 STDIO 服务器，连接到提供专项功能的远程服务器
    4.

传输方式对比

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

在 Bob Shell 中配置传输方式

有关在 Bob Shell 中配置传输方式的详细信息（包括配置示例），请参阅 Bob Shell 中的 MCP。

这个主题怎么样？

本页内容

概述STDIO 传输STDIO 传输的工作原理STDIO 传输特性何时使用 STDIOSTDIO 实现示例Streamable HTTP 传输Streamable HTTP 传输的工作原理Streamable HTTP 传输特性何时使用 Streamable HTTPStreamable HTTP 实现示例与 HTTP+SSE 的向后兼容性SSE 传输（已移除）从 SSE 传输迁移部署注意事项STDIO：本地部署远程：托管部署混合方式传输方式对比在 Bob Shell 中配置传输方式