SSE MCP Server

SSE MCP Server

このリポジトリは、Server-Sent Events (SSE) を使用したModel Context Protocol (MCP) サーバーのサンプル実装です。Netlify Edge Functionsを使用してデプロイできるように設計されています。

最新の更新

• 2025/3/11: Netlify Edge Functionsでの502エラーを修正しました。SSE接続を維持するために定期的なpingメッセージを送信する機能を追加しました。

機能

• SSEを使用したリアルタイム通信
• Netlify Edge Functionsでのサーバーサイド実装
• シンプルなクライアントインターフェース

開発環境のセットアップ

1. リポジトリをクローン

   git clone https://github.com/yourusername/sse-mcp-server.git
   cd sse-mcp-server
   

2. 依存関係をインストール

   npm install
   

3. 開発サーバーを起動

   npm run dev
   

Netlifyへのデプロイ

1. Netlify CLIをインストール（既にインストール済みの場合はスキップ）

   npm install -g netlify-cli
   

2. Netlifyにログイン

   netlify login
   

3. サイトを初期化（初回のみ）

   netlify init
   

4. デプロイ

   npm run deploy
   

Netlifyデプロイ後の動作確認方法

デプロイが完了したら、以下の手順で動作確認を行うことができます：

1. デプロイされたサイトのURLにアクセスする

   • デプロイ完了時にコンソールに表示されるURLか、Netlifyダッシュボードから確認できます
   • 例: https://your-site-name.netlify.app

2. トップページにアクセスすると、「SSE MCP Server is running. Access /sse to connect.」というメッセージが表示されます

   • これはサーバーが正常に動作していることを示しています

3. デモページを使用してSSE接続をテストする

   • トップページ（index.html）にはSSE接続をテストするためのUIが用意されています
   • 「接続」ボタンをクリックしてSSEサーバーに接続します
   • 接続が成功すると、ステータスが「接続中」に変わり、接続IDが表示されます

4. メッセージの送受信をテストする

   • テキスト入力欄にメッセージを入力し、「送信」ボタンをクリックします
   • 送信したメッセージがサーバーから返信され、画面に表示されます

5. 以下の点を確認する

   • 接続状態が正しく表示されるか
   • 定期的なpingメッセージが受信されるか
   • メッセージの送受信が正常に行われるか
   • エラー発生時の処理が適切に行われるか

6. 必要に応じて、開発者ツール（F12）のネットワークタブでSSE接続の詳細を確認する

   • /sse エンドポイントへのリクエストと、イベントストリームの状態を確認できます
   • /message エンドポイントへのPOSTリクエストが正常に処理されているか確認できます

これらの確認が成功すれば、SSE MCP Serverが正常にNetlifyにデプロイされ、動作していることが確認できます。

ファイル構成

• everything.ts - MCPサーバーの実装
• sse.ts - Express.jsを使用したSSEサーバー
• netlify/edge-functions/sse.ts - Netlify Edge Functionsを使用したSSEサーバー
• index.html - クライアント側のデモページ

ライセンス

MITライセンス