24_FastMCP 2.x 中文文档之FastMCP服务端认证：构建完整的 OAuth 服务器详解

一、完整的 OAuth 服务器

构建一个独立的身份验证系统，让您的 FastMCP 服务器在其中管理用户、颁发令牌并验证它们。

版本 2.11.0 新增：

警告：这是一个极其高级的模式，大多数用户应该避免使用。构建安全的 OAuth 2.1 服务器需要深厚的认证协议、密码学和安全最佳实践专业知识。复杂性远远超出了初始实现，包括持续的安全监控、威胁响应和合规性维护。

除非您有外部身份提供程序无法满足的强制性要求，例如隔离环境或特殊合规性需求，否则请改用远程 OAuth。

完整 OAuth 服务器模式存在是为了支持 MCP 协议规范的要求。您的 FastMCP 服务器既成为授权服务器又成为资源服务器，处理从用户登录到令牌验证的完整认证生命周期。

本文档为了完整性而存在 - 绝大多数应用程序应该使用外部身份提供程序。

二、OAuthProvider

FastMCP 提供实现 OAuth 2.1 规范的 OAuthProvider 抽象类。要使用此模式，您必须子类化 OAuthProvider 并实现所有必需的抽象方法。

注意：OAuthProvider 处理 OAuth 端点、协议流和安全要求，但将所有存储、用户管理和业务逻辑委托给您对抽象方法的实现。

三、必需实现

您必须实现这些抽象方法来创建功能正常的 OAuth 服务器：

3.1 客户端管理