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

使用 Bun 和 Elysia 网络框架实现的模型上下文协议（MCP）服务器。该项目使您能够创建高性能的 MCP 服务器，通过标准化接口公开资源、工具和提示到大语言模型（LLM）。

特性

• 使用 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 兼容构建。

开发

项目结构

• src/index.ts - 服务器的主要入口点
• src/SSEElysiaTransport.ts - Bun 和 Elysia 的 SSE 传输实现

创建 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 运行");
});

调试

您可以使用 MCP 监视器工具并通过 SSE 连接进行调试

npx @modelcontextprotocol/inspector

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

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

贡献

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

许可证

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