MCP Joke Server with Authentication

MCP 身份验证示例 🚀

此仓库包含使用 FastAPI 和 FastMCP 构建带身份验证的 Model Context Protocol（MCP）服务的示例代码。

运行服务 🖥️

1. 在 VS Code 中打开此文件夹 2.（如果使用 devcontainer）按提示点击“Reopen in Container”
2. 安装依赖项：

   pip install -r requirements.txt
   

3. 启动服务：

   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、作用域和颁发者。

示例：oauth-protected-resource.json 📄

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

将占位符替换为实际值。

GitHub Copilot Agent 模式 🤖

此 MCP 服务也可在 VS Code 的 GitHub Copilot Agent 模式下使用。启用方法如下：

1. 确保服务正在运行。
2. 使用 mcp.json 文件为 GitHub Copilot 配置 MCP 服务。
3. 根据 mcp.json 配置启动服务。

测试 🧪

你可以使用 curl 测试受保护的端点：

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

如果未提供令牌或令牌无效，你将收到 401 Unauthorized 响应。

许可证 📜

请参阅 LICENSE。