Bun MCP Sse Transport

🚀 bun - mcp - sse - transport

このプロジェクトは、BunをベースにしたModel Context Protocol (MCP)のサーバー送信イベント（SSE）トランスポートの実装です。主に、MCPサーバーに対して、Bunランタイム向けのSSEトランスポートを提供し、リアルタイムでサーバーからクライアントへの一方向通信を可能にします。また、HTTP POSTリクエストを通じてクライアントからサーバーへの通信も処理します。

🚀 クイックスタート

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)
  }
});

✨ 主な機能

• Bunランタイム専用に設計されています。
• MCPトランスポートインターフェースを実装しています。
• 適切なヘッダーを持つSSE接続を管理します。
• 受信したJSON - RPCメッセージを処理します。
• Bun.serveと簡単に統合できます。

📚 ドキュメント

動作原理

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

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