MCP Joke Server with Authentication

MCP 認証サンプル 🚀

このリポジトリには、FastAPI と FastMCP を使用して認証機能付きの Model Context Protocol（MCP）サーバーを構築するためのサンプルコードが含まれています。

サーバーの起動 🖥️

1. VS Code でこのフォルダーを開きます
2. （devcontainer を使用する場合）プロンプトが表示されたら「Reopen in Container」をクリックします
3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. サーバーを起動します：

   python server.py
   

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

Microsoft Entra ID（Azure AD）による認証 🔐

このサンプルでは、Microsoft Entra ID（Azure AD）の OAuth2 Bearer トークンを使用して、MCP サーバーを保護する方法を紹介します。

Entra ID アプリケーションの必須設定 🛠️

1. Azure Portal から Microsoft Entra ID（Azure AD）にアプリケーションを登録します。
2. API を公開します：
   • アプリの登録画面で「Expose an API」に移動します。
   • アプリケーション ID URI（例：api://<APPUUID>）を設定します。
   • スコープ（例：mcp.tools）を追加します。
3. 認証を構成します：
   • クライアントで必要な場合は、リダイレクト URI を追加します。
4. アプリの以下の値を取得します：
   • テナント ID
   • アプリケーション（クライアント）ID
   • アプリケーション ID URI
   • スコープ名

コードとリソースのメタデータを更新する ✏️

• server.py の BearerAuthProvider を更新します：

  • <ENTRATENANTID> を Entra テナント ID に置き換えます。
  • <APPUUID> をアプリケーション（クライアント）ID またはアプリケーション ID URI に置き換えます。
  • 正しい jwks_uri、issuer、audience、required_scopes を設定します。

  例：

  auth = BearerAuthProvider(
      jwks_uri="https://login.microsoftonline.com/<ENTRATENANTID>/discovery/v2.0/keys",
      issuer="https://sts.windows.net/<ENTRATENANTID>/",
      algorithm="RS256",
      audience="api://<APPUUID>",
      required_scopes=["mcp.tools"]
  )
  

• oauth-protected-resource.json を更新します：

  • リソース ID、スコープ、issuer など、このファイルがアプリケーションのメタデータと一致していることを確認します。

例：oauth-protected-resource.json 📄

{
  "resource": "api://<APPUUID>",
  "issuer": "https://sts.windows.net/<ENTRATENANTID>/",
  "scopes": ["mcp.tools"]
}

プレースホルダーを実際の値に置き換えます。

GitHub Copilot Agent Mode 🤖

この MCP サーバーは、VS Code の GitHub Copilot Agent mode でも使用できます。有効にするには、以下の手順を実行します：

1. サーバーが起動していることを確認します。
2. mcp.json ファイルを使用して、GitHub Copilot 用に MCP サーバーを構成します。
3. mcp.json の構成からサーバーを起動します。

テスト 🧪

curl を使用して、保護されたエンドポイントをテストできます：

curl -H "Authorization: Bearer <token>" http://localhost:8000/mcp

トークンが指定されていない場合、または無効なトークンが指定された場合は、401 Unauthorized レスポンスが返されます。

ライセンス 📜

LICENSE を参照してください。