Elysia MCP

🚀 使用 Bun 和 Elysia 實現的 MCP 服務器

本項目藉助 Bun 和 Elysia 網絡框架，打造了一個模型上下文協議（MCP）服務器。它能讓你創建高性能的 MCP 服務器，通過標準化接口將資源、工具和提示公開給大語言模型（LLM）。

🚀 快速開始

本項目使用 Bun 和 Elysia 網絡框架實現了 MCP 服務器，讓你可以輕鬆創建高性能的 MCP 服務器並將資源等公開給大語言模型。

先決條件

• 系統上安裝了 Bun
• 對 TypeScript 和 Elysia 有基本的瞭解

安裝

# 克隆倉庫
git clone <your-repo-url>
cd mcp-server

# 安裝依賴項
bun install

啟動服務器

# 啟動服務器
bun start

# 開發時使用熱重載啟動
bun dev

生產環境構建

# 為生產環境構建
bun run build

這將在 dist 目錄中創建一個精簡的 Node.js 兼容構建。

✨ 主要特性

• 使用 Bun 和 Elysia 實現的服務器發送事件（SSE）傳輸
• 完整支持 MCP 協議，涵蓋資源、工具和提示
• 得益於 Bun 的 JavaScript 運行時，具備高性能
• 帶有正確類型定義的 TypeScript 支持
• 擁有創建兼容 MCP 服務器的易用 API

📦 安裝指南

# 克隆倉庫
git clone <your-repo-url>
cd mcp-server

# 安裝依賴項
bun install

💻 使用示例

基礎用法

啟動服務器

# 啟動服務器
bun start

# 開發時使用熱重載啟動
bun dev

生產環境構建

# 為生產環境構建
bun run build

高級用法

創建 MCP 服務器

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import { SSEElysiaTransport } from "./SSEElysiaTransport";
import { Elysia } from "elysia";

// 創建 MCP 服務器
const server = new McpServer({
  name: "my-mcp-server",
  version: "1.0.0"
});

// 添加資源、工具和提示
server.resource(
  "example", 
  "example://resource", 
  async (uri) => ({
    contents: [{
      uri: uri.href,
      text: "示例資源內容"
    }]
  })
);

// 創建 Elysia 應用程序
const app = new Elysia()
  .get("/", () => "MCP 服務器")
  .get("/sse", async (context) => {
    try {
      // 創建傳輸
      const transport = new SSEElysiaTransport("/messages", context);
      
      // 存儲傳輸
      const sessionId = transport.sessionId;
      // ... 將傳輸存儲在映射中
      
      // 連接到 MCP 服務器
      await server.connect(transport);
      
      return;
    } catch (error) {
      // 處理錯誤
    }
  })
  .post("/messages", async (context) => {
    // 處理傳入的消息
  });

// 啟動服務器
app.listen(3001, () => {
  console.log("MCP 服務器在 http://localhost:3001 運行");
});

🔧 技術細節

項目結構

• src/index.ts - 服務器的主要入口點
• src/SSEElysiaTransport.ts - Bun 和 Elysia 的 SSE 傳輸實現

調試

你可以使用 MCP 監視器工具並通過 SSE 連接進行調試。

npx @modelcontextprotocol/inspector

這將打開一個網絡界面，你可以在其中：

• 列出可用的資源、工具和提示
• 測試調用工具和檢索資源
• 檢查客戶端與服務器之間的通信

📄 許可證

該項目根據 MIT 許可證發佈，詳細信息見 LICENSE 文件。

貢獻

歡迎貢獻！請隨意提交 Pull Request。