bun-mcp-sse-transport

bun-mcp-sse-transport

Bun を使用した Model Context Protocol（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";

// Create SSE transport
const transport = new BunSSEServerTransport("/messages");

// Connect to MCP server
const server = new McpServer({ name: "MyServer", version: "1.0.0" });
server.connect(transport);

// Set up Bun HTTP server
Bun.serve({
  port: 3000,
  routes: {
    "/sse": () => transport.createResponse(),
    "/messages": (req) => transport.handlePostMessage(req)
  }
});

仕組み

1. クライアントが /sse に接続すると、サーバーが SSE 接続を作成します
2. サーバーは、クライアントがメッセージを POST するエンドポイント URL を送信します
3. クライアントは、エンドポイント URL に JSON-RPC メッセージを送信します
4. サーバーはこれらのメッセージを受信し、MCP サーバーに渡します
5. MCP サーバーはメッセージを処理し、SSE 接続を介して応答を送信します

この実装は、効率的なリアルタイム通信を実現するために Bun のストリーミング機能を活用しながら、MCP 標準に準拠しています。