Bun MCP Sse Transport

🚀 bun-mcp-sse-transport

An implementation of Server-Sent Events (SSE) transport for the Model Context Protocol (MCP) based on Bun.

🚀 Quick Start

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

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

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

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

✨ Features

• Specifically designed for the Bun runtime.
• Implements the MCP transport interface.
• Manages SSE connections with correct headers.
• Handles incoming JSON-RPC messages.
• Easily integrates with Bun.serve.

📚 Documentation

Overview

This package provides an SSE transport implementation for MCP servers specifically tailored to the Bun runtime. It enables real-time, one-way communication from the server to the client using the SSE protocol and handles client-to-server communication via HTTP POST requests.

How It Works

1. When a client connects to /sse, the server creates an SSE connection.
2. The server sends the endpoint URL to which the client should POST messages.
3. The client sends JSON-RPC messages to this endpoint URL.
4. The server receives these messages and passes them to the MCP server.
5. The MCP server processes the messages and sends responses through the SSE connection.

This implementation adheres to the MCP standard while leveraging Bun's streaming capabilities for efficient real-time communication.