Sse MCP Server

🚀 SSE MCP サーバ

このリポジトリは、Server-Sent Events (SSE) を使用して Model Context Protocol (MCP) を実装したサーバー側のサンプル実装です。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 正常運行中。/sse へ接続します。」というメッセージが表示されます。
   • これはサーバーが正常に動作していることを示しています。
3. サンプルページを使用して SSE 接続をテストします。
   • ホームページ（index.html）には、SSE 接続をテストするためのユーザーインターフェイスが用意されています。
   • 「接続」ボタンをクリックして SSE サーバーに接続します。
   • 接続が成功すると、状態が「接続中」と表示され、接続 ID が表示されます。
4. メッセージの送受信をテストします。
   • テキスト入力ボックスにメッセージを入力し、「送信」ボタンをクリックします。
   • 送信されたメッセージはサーバーから返され、画面に表示されます。
5. 以下の内容を確認します。
   • 状態が正しく表示されているか
   • 定期的に ping メッセージを受信できるか
   • メッセージの送受信が正常に行われるか
   • エラー処理が適切に行われるか
6. 必要に応じて、開発者ツール（F12）のネットワークタブを使用して SSE 接続を詳細に確認します。
   • /sse エンドポイントのリクエストとイベントストリームの状態を確認します。
   • /message エンドポイントの POST リクエストが正常に処理されていることを確認します。

上記の検証手順が正常に完了すると、サーバーが正常に動作しており、ユーザーが接続とメッセージの送受信を円滑に行えることが保証されます。

✨ 主な機能

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

📦 インストール

開発環境のセットアップと Netlify へのデプロイに関する手順は、「クイックスタート」セクションを参照してください。

🔧 技術詳細

ファイル構造

• everything.ts: 重要なロジックファイルで、MCP プロトコルの核心実装を含みます。
• sse.ts: SSE 関連のロジック実装。
• その他のファイル: プロジェクト全体の設定とインターフェイス実装をサポートします。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。

🌟 最新更新

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