Bun MCP Sse Transport

🚀 bun-mcp-sse-transport

本項目是一個基於Bun實現的Model Context Protocol (MCP)服務器發送事件（SSE）傳輸方案。它能助力開發者在Bun運行時實現高效、即時的服務器與客戶端通信，為MCP應用提供強大支持。

🚀 快速開始

以下是一個快速使用示例，展示瞭如何在項目中集成 bun-mcp-sse-transport：

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運行時設計：充分利用Bun的性能優勢，確保在Bun環境下高效運行。
• 實現MCP傳輸接口：嚴格遵循MCP標準，為MCP服務器提供可靠的傳輸支持。
• 管理帶有正確標頭的SSE連接：確保SSE連接的穩定性和正確性，實現即時、單向的服務器到客戶端通信。
• 處理傳入的JSON - RPC消息：能夠準確解析和處理客戶端發送的JSON - RPC消息。
• 與Bun.serve簡單集成：方便開發者將其集成到現有的Bun項目中。

📚 詳細文檔

工作原理

1. 當客戶端連接到/sse時，服務器創建一個SSE連接。
2. 服務器發送客戶端應POST消息的端點URL。
3. 客戶端將JSON - RPC消息發送到該端點URL。
4. 服務器接收這些消息並將其傳遞給MCP服務器。
5. MCP服務器處理消息並將響應通過SSE連接發送。

此實現遵循MCP標準，同時利用Bun的流式功能實現高效的即時通信。