mcpField
B
bun-mcp-sse-transport

bun-mcp-sse-transport

Local
github.com/tigranbsDeveloper Tools13Updated 81w ago

About bun-mcp-sse-transport

bun-mcp-sse-transport is a Bun-specific SSE transport for MCP servers. It supports server-to-client event streams and client messages sent through HTTP POST.

Key features

  1. 01Bun runtime implementation
  2. 02MCP transport interface
  3. 03SSE connection and headers
  4. 04JSON-RPC message handling
  5. 05Bun.serve integration

Use cases

  1. 01Adding SSE transport to a Bun MCP server
  2. 02Sending server events to connected clients
  3. 03Receiving client messages through HTTP POST

MCP support

Implements SSE transport for MCP servers. It streams server messages to clients and receives client JSON-RPC messages over HTTP POST.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

bun-mcp-sse-transport

A Server-Sent Events (SSE) transport implementation for the Model Context Protocol (MCP) using Bun.

Overview

This package provides a Bun-specific implementation of SSE transport for MCP servers. It enables real-time, one-way communication from server to client using the SSE protocol, with client-to-server communication handled via HTTP POST requests.

Key Features

  • Built specifically for Bun runtime
  • Implements the MCP transport interface
  • Manages SSE connections with proper headers
  • Handles incoming JSON-RPC messages
  • Simple integration with Bun.serve

Quick Usage

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

How It Works

  1. When a client connects to /sse, the server creates an SSE connection
  2. The server sends the endpoint URL where the client should POST messages
  3. The client sends JSON-RPC messages to the 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 via the SSE connection

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.