bun-mcp-sse-transport

一个使用 Bun 实现的，用于模型上下文协议 (MCP) 的 Server-Sent Events (SSE) 传输实现。

概述

此包为 MCP 服务器提供了一个特定于 Bun 的 SSE 传输实现。它通过 SSE 协议实现从服务器到客户端的实时单向通信，而客户端到服务器的通信则通过 HTTP POST 请求处理。

主要特性

• 专为 Bun 运行时构建
• 实现 MCP 传输接口
• 使用正确的标头管理 SSE 连接
• 处理传入的 JSON-RPC 消息
• 与 Bun.serve 简单集成

快速使用

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { BunSSEServerTransport } from "bun-mcp-sse-transport";

// 创建 SSE 传输
const transport = new BunSSEServerTransport("/messages");

// 连接到 MCP 服务器
const server = new McpServer({ name: "MyServer", version: "1.0.0" });
server.connect(transport);

// 设置 Bun HTTP 服务器
Bun.serve({
  port: 3000,
  routes: {
    "/sse": () => transport.createResponse(),
    "/messages": (req) => transport.handlePostMessage(req)
  }
});

工作原理

1. 当客户端连接到 /sse 时，服务器创建一个 SSE 连接
2. 服务器发送客户端应该 POST 消息的端点 URL
3. 客户端将 JSON-RPC 消息发送到端点 URL
4. 服务器接收这些消息并将它们传递给 MCP 服务器
5. MCP 服务器处理消息并通过 SSE 连接发送响应

此实现遵循 MCP 标准，同时利用 Bun 的流式传输功能来实现高效的实时通信。