Elysia MCP

🚀 BunとElysiaを使用したMCPサーバー

このプロジェクトは、BunとElysia Webフレームワークを用いて、モデルコンテキストプロトコル（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互換のビルドが作成されます。

基本的な使用法

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

これにより、Webインターフェースが開き、以下のことができます。

• 利用可能なリソース、ツール、およびプロンプトを一覧表示する
• ツールの呼び出しとリソースの取得をテストする
• クライアントとサーバー間の通信を確認する

コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。