Elysia MCP

一個基於Bun和Elysia框架實現的MCP協議服務器，提供高性能的資源、工具和提示詞標準化接口，支持SSE傳輸協議和TypeScript類型定義。

開發者工具人工智能聊天機器人 #協議服務器 #高性能 #SSE傳輸 #LLM接口 .TypeScript

評分 : 2分

下載量 : 6.2K

更新時間 : 2025-04-28

打開站點

什麼是MCP服務器？

MCP服務器是一種用於與大型語言模型（LLMs）通信的工具，它通過標準協議提供資源、工具和提示。這種服務器可以幫助開發者更高效地構建和管理與AI模型交互的應用。

如何使用MCP服務器？

使用MCP服務器非常簡單。您只需安裝並啟動服務器，然後通過瀏覽器或專用工具連接到它，即可開始探索其功能。

適用場景

MCP服務器適用於需要與AI模型進行復雜交互的場景，例如自然語言處理、數據分析和自動化任務。

主要功能

服務器發送事件（SSE）支持

通過SSE實現高效的即時數據流傳輸，確保快速響應。

資源管理

輕鬆添加和管理多種類型的資源，如文件、數據庫記錄等。

工具集成

支持多種工具的集成，方便開發者調用自定義邏輯。

提示管理

預定義提示模板，幫助用戶快速生成高質量輸入。

優勢

高性能：基於Bun運行時，速度快且穩定。

易用性：提供直觀的API設計，降低開發門檻。

靈活性：支持多種協議和擴展點，滿足多樣化需求。

侷限性

依賴特定環境：需要Bun和Elysia的支持。

初期學習曲線：對新手來說可能需要一些時間熟悉。

如何使用

安裝MCP服務器

克隆項目倉庫並安裝依賴。

啟動服務器

運行命令啟動本地服務器。

連接客戶端

使用瀏覽器或專用工具連接到服務器。

使用案例

添加資源

向服務器添加一個示例資源。

測試工具

驗證工具是否正常工作。

常見問題

MCP服務器是什麼？

如何安裝MCP服務器？

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 運行");
});