SSE MCP Server with JWT Authentication

🔐 JWT 認証を備えた SSE MCP サーバー

これは、JWT ベースの認証を備えたモデル コンテキスト プロトコル (MCP) SSE サーバーです。
安全なベアラー トークン フローによって保護された SSE トランスポートを介して複数の AI ツールを公開できます。

搭載コンポーネント:

• 🚀 Node.js + エクスプレス
• 🧩 @modelcontextprotocol/sdk
• 🔒 認証のためのJSON Web Token（JWT）
• ⚙️ 入力検証のための Zod

✅ @modelcontextprotocol/inspectorで完全にテスト済み

📂 プロジェクト構造

✨ 特徴

• ✅ Bearer JWT トークンを使用した安全な SSE 接続
• ✅ 動的ツールの登録（エコー、時間、乱数など）
• ✅ MCP Inspectorでテスト済み
• ✅ すべてのリクエストライフサイクルイベントをログに記録します
• ✅ /message エンドポイントのセッション管理
• 🚀 本番環境での使用に拡張可能

⚙️ セットアップ

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

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

3. .envファイルを作成する

4. サーバーを実行する

✅ サーバーは以下で実行されます:

🧪 MCP Inspector でサーバーをテストする

ステップ1 - MCP Inspectorをインストールする

📖 公式ドキュメント: MCP インスペクター

ステップ2 — トークンを生成する

cURL を使用して JWT トークンを取得します。

✅ 回答例:

ステップ3 - MCP Inspectorを接続する

1. インスペクターUIを開く
2. トランスポートタイプを設定: SSE
3. URL:
   http://localhost:3001/sse
4. 認証ヘッダーを追加します:
   Authorization: Bearer <your-token>
5. **「接続」**をクリック

🎉 成功しました！サーバーが接続されました。

ステップ4 — テストツール

インスペクタの**「ツール」**タブに移動し、 「リスト ツール」をクリックします。

次のように表示されます。

• ✅ test
• ✅ echo
• ✅ get-time
• ✅ random-number

ぜひテストして楽しんでください！

📖 APIリファレンス

🔑 トークンを生成する

🔌 SSEエンドポイント（トークンが必要）

📩 アクティブセッションにメッセージを送信する

🧩 ツールリファレンス

🗓️ 今後の変更点

• [ ] トークン失効リスト（ブラックリスト）
• [ ] ロールベースのツールアクセス（スコープチェック）
• [ ] セッションハートビート/キープアライブ
• [ ] レート制限とログ記録
• [ ] デプロイメントのためのDocker化

📚 役立つリソース

• モデルコンテキストプロトコルの概要
• MCP インスペクター ドキュメント
• JWT.io デバッガー
• Zod 検証ドキュメント

👨‍💻 メンテナー

アニケット

📄 ライセンス

このプロジェクトはオープンソースであり、無料で使用できます。

🚀 構築する。保護する。強化する。