MCP Authentication Samples

🚀 MCP ジョークサーバー（認証付き）

このプロジェクトは、FastAPI を用いて実装された Model Context Protocol (MCP) サーバーのサンプルです。トークンベースの認証付きで、プログラミングに関するジョークを提供します。

🚀 クイックスタート

環境構築

1. VS Code でこのフォルダを開きます。
2. ポップアップが表示されたら、「コンテナ内で再開」をクリックして、devcontainer 設定を使用します。
3. コンテナは自動的に requirements.txt からすべての依存関係をインストールします。

サーバーの起動

python server.py

サーバーは http://localhost:8000 で起動します。

✨ 主な機能

この MCP サーバーは、簡単なジョーク提供機能を備えています。呼び出されるたびに、プログラミング関連のジョークのコレクションを循環します。主な機能は以下の通りです。

1. 単一の MCP ツール tell_joke を実装しています。
2. 呼び出すたびに異なるプログラミングジョークを返します。
3. SSE エンドポイントにアクセスするには認証が必要です。

🔧 認証

サーバーは、SSE エンドポイント (/sse) に対して、簡単なトークンベースの認証を実装しています。リクエストを行うには、HTTP ヘッダーに有効な Bearer トークンを含める必要があります。

このデモでは、以下のトークンを使用してください：valid_token

curl リクエストの例：

curl http://localhost:8000/sse \
  -H "Authorization: Bearer valid_token"

有効なトークンを提供しない SSE エンドポイントへのリクエストは、401 Unauthorized レスポンスを受け取ります。

💻 使用例

VS Code Copilot との統合

このサーバーは、VS Code で GitHub Copilot が使用するカスタムジョークプロキシとして利用できます。使用するには：

1. python server.py を実行して MCP サーバーを起動します。
2. .vscode/settings.json で VS Code の設定がこのサーバーを使用するように既に構成されています。
3. サーバーは MCP プロトコルを通じて、ジョークのリクエストに応答します。

サポートされる機能

• MCP ツールを通じたジョーク提供
• SSE エンドポイントのトークンベース認証
• FastAPI ベースの HTTP サーバー

📚 詳細ドキュメント

セキュリティに関する注意事項

これはデモ実装です。本番環境では、以下のことを行う必要があります。

1. 適切な認証方法を使用する。
2. シークレットを安全に保管する。
3. 有効なトークンの発行と管理を実装する。
4. HTTPS を使用する。
5. レート制限やその他のセキュリティ対策を追加する。