Elysia MCP

🚀 使用 Bun 和 Elysia 实现的 MCP 服务器

本项目借助 Bun 和 Elysia 网络框架，打造了一个模型上下文协议（MCP）服务器。它能够创建高性能的 MCP 服务器，通过标准化接口将资源、工具和提示公开给大语言模型（LLM）。

🚀 快速开始

本项目使用 Bun 和 Elysia 网络框架实现 MCP 服务器，让你能轻松创建高性能的 MCP 服务器，并将资源、工具和提示公开给大语言模型。

✨ 主要特性

• 采用 Bun 和 Elysia 实现服务器发送事件（SSE）传输。
• 全面支持 MCP 协议，涵盖资源、工具和提示。
• 依托 Bun 的 JavaScript 运行时，具备高性能。
• 支持带有正确类型定义的 TypeScript。
• 提供创建兼容 MCP 服务器的易用 API。

📦 安装指南

先决条件

• 系统上安装了 Bun
• 对 TypeScript 和 Elysia 有基本了解

安装步骤

# 克隆仓库
git clone <your-repo-url>
cd mcp-server

# 安装依赖项
bun install

💻 使用示例

启动服务器

# 启动服务器
bun start

# 开发时使用热重载启动
bun dev

生产环境构建

# 为生产环境构建
bun run build

这将在 dist 目录中创建一个精简的 Node.js 兼容构建。

基础用法

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

这将打开一个网络界面，你可以在其中：

• 列出可用的资源、工具和提示
• 测试调用工具和检索资源
• 检查客户端与服务器之间的通信

贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

该项目根据 MIT 许可证发布，详细信息见 LICENSE 文件。