MCP Server Com Sse E Autenticacao Bearer

🚀 SSEとBearer認証に基づくモデルコンテキストプロトコルサーバ

このプロジェクトは、TypeScriptで開発されたMCP（Model Context Protocol）サーバの実装です。このサーバは、Server-Sent Events (SSE) を使用してリアルタイム通信を実現し、Bearer Tokenを用いて認証を行います。プロジェクトの構造は明確で、機能モジュールも明確に分かれています。

🚀 クイックスタート

開発環境のセットアップ

1. リポジトリをローカルにクローンします：

   git clone [リポジトリのURL]
   cd mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. 開発サーバを起動します：

   npm run dev
   

本番環境のデプロイ

1. プロジェクトをコンパイルします：

   npm run build
   

2. コンパイル後のファイルを実行します：

   node dist/index.js
   

✨ 主な機能

• リアルタイム通信: SSE技術を採用して長時間のポーリングを実現し、低遅延のメッセージ伝達を保証します。
• 認証機能: Bearer Tokenを使用したステートレス認証により、セキュリティを向上させます。
• モジュール化構造: 各機能モジュールは独立して開発されており、メンテナンスと拡張が容易です。
• 拡張性: 新しいツールやサービスの追加をサポートし、様々なニーズに柔軟に対応できます。
• 高性能: Expressフレームワークに基づいており、優れたパフォーマンスを発揮します。
• 安全性: Bearer Token認証メカニズムにより、通信の安全性が確保されます。
• 使いやすさ: シンプルなAPIインターフェースを提供し、統合と使用が容易です。

📦 インストール

• Node.js & npm: 最新の安定版をインストールしてください（推奨: v14以上）。
• ts-node: TypeScriptファイルを直接実行するために使用します。
• @types/express: Expressフレームワークの型定義です。
• express: 基本的なWebフレームワークです。
• ws: WebSocket通信をサポートします。

📚 ドキュメント

プロジェクトアーキテクチャ

コアモジュール

• MCP Module: MCPサーバインスタンスの作成と設定を担当し、ツールの登録とSSE接続を管理します。
• ミドルウェア: Bearer Token認証、CORSサポート、およびリクエスト解析機能を提供します。
• ルーティング: 主要なインターフェース /sse と /messages の処理ロジックを実装しています。
• 設定ファイル: サーバのポート、セッションの有効期限などの重要なパラメータを定義しています。
• アプリケーション層: 各モジュールを統合し、サーバが正常に動作するようにします。

システムフロー

1. 接続の確立:

   • クライアントは GET /sse リクエストを使用してサーバとSSEチャネルを確立し、Bearer Tokenを提供して認証を行います。
   • サーバはTokenを検証した後、新しいSSEトランスポートインスタンスを作成し、クライアントに一意のセッションIDを割り当てます。
   • MCPサーバはSSEトランスポートインスタンスに接続し、通信を初期化し、ツールリストなどの初期メッセージを送信します。

2. メッセージ処理:

   • クライアントは /messages インターフェースにセッションIDを含むメッセージリクエストを送信します。
   • サーバはセッションIDを使用して対応するSSEトランスポートインスタンスを検索し、受信したメッセージをMCPサーバに転送して処理します。
   • 処理が完了すると、結果はSSEチャネルを通じてクライアントに返されます。

3. 接続の切断:

   • クライアントがSSE接続を閉じると、サーバは状態の変化を検出し、対応するセッションIDのトランスポートインスタンスをクリーンアップします。

シーケンス図

以下は、プロジェクトのやり取りのフローチャートです。

@startuml

title "SSEとBearer認証に基づくMCPサーバの通信フロー"

actor "MCPクライアント" as Client

participant "Expressサーバ" as Express
participant "Authミドルウェア" as Auth
participant "ルート /sse" as SSERoute
participant "SSEトランスポート層" as SSE
participant "MCPサーバ" as MCP
participant "ルート /messages" as MsgRoute

== 接続の確立 ==
Client -> Express: GET /sse\n(Authorization: Bearer <token>)
Express -> Auth: Bearer Tokenの検証
Auth -> Client: 200 OK
Client -> SSERoute: SSEチャネルの確立
SSERoute -> SSE: トランスポートインスタンスの作成
SSE -> MCP: 接続の初期化

== メッセージの送信 ==
Client -> MsgRoute: POST /messages\n(セッションID)
MsgRoute -> SSE: トランスポートインスタンスの取得
SSE -> MCP: メッセージの転送
MCP -> SSE: 処理結果の返送
SSE -> Client: 応答の受信

== 接続の切断 ==
Client -> SSE: チャネルの閉鎖
SSE -> SSERoute: 切断の通知
SSERoute -> Express: リソースのクリーンアップ

@enduml

🔧 技術詳細

このプロジェクトは、Server-Sent Events (SSE) を使用してリアルタイム通信を実現し、Bearer Tokenを用いて認証を行います。TypeScriptで開発されており、Expressフレームワークをベースにしています。各機能モジュールは独立して開発されており、メンテナンスと拡張が容易です。

展望

将来的には、以下の機能を追加する予定です。

1. WebSocketプロトコルをサポートして、通信効率を向上させます。
2. メッセージキュー機構を実装して、システムのスループットを向上させます。
3. ログ記録と監視モジュールを追加して、運用管理を容易にします。