fastmcp 2.12.0rc1__py3-none-any.whl → 2.12.2__py3-none-any.whl

fastmcp/server/auth/providers/google.py

@@ -30,7 +30,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDict
 from fastmcp.server.auth import TokenVerifier
 from fastmcp.server.auth.auth import AccessToken
 from fastmcp.server.auth.oauth_proxy import OAuthProxy
-from fastmcp.server.auth.registry import register_provider
 from fastmcp.utilities.auth import parse_scopes
 from fastmcp.utilities.logging import get_logger
 from fastmcp.utilities.types import NotSet, NotSetT
@@ -53,7 +52,6 @@ class GoogleProviderSettings(BaseSettings):
     redirect_path: str | None = None
     required_scopes: list[str] | None = None
     timeout_seconds: int | None = None
-    resource_server_url: AnyHttpUrl | str | None = None
     allowed_client_redirect_uris: list[str] | None = None
 
     @field_validator("required_scopes", mode="before")
@@ -181,7 +179,6 @@ class GoogleTokenVerifier(TokenVerifier):
             return None
 
 
-@register_provider("Google")
 class GoogleProvider(OAuthProxy):
     """Complete Google OAuth provider for FastMCP.
 
@@ -203,7 +200,7 @@ class GoogleProvider(OAuthProxy):
         auth = GoogleProvider(
             client_id="123456789.apps.googleusercontent.com",
             client_secret="GOCSPX-abc123...",
-            base_url="https://my-server.com"  # Optional, defaults to http://localhost:8000
+            base_url="https://my-server.com"
         )
 
         mcp = FastMCP("My App", auth=auth)
@@ -219,7 +216,6 @@ class GoogleProvider(OAuthProxy):
         redirect_path: str | NotSetT = NotSet,
         required_scopes: list[str] | NotSetT = NotSet,
         timeout_seconds: int | NotSetT = NotSet,
-        resource_server_url: AnyHttpUrl | str | NotSetT = NotSet,
         allowed_client_redirect_uris: list[str] | NotSetT = NotSet,
     ):
         """Initialize Google OAuth provider.
@@ -237,6 +233,7 @@ class GoogleProvider(OAuthProxy):
             allowed_client_redirect_uris: List of allowed redirect URI patterns for MCP clients.
                 If None (default), all URIs are allowed. If empty list, no URIs are allowed.
         """
+
         settings = GoogleProviderSettings.model_validate(
             {
                 k: v
@@ -247,7 +244,6 @@ class GoogleProvider(OAuthProxy):
                     "redirect_path": redirect_path,
                     "required_scopes": required_scopes,
                     "timeout_seconds": timeout_seconds,
-                    "resource_server_url": resource_server_url,
                     "allowed_client_redirect_uris": allowed_client_redirect_uris,
                 }.items()
                 if v is not NotSet
@@ -265,12 +261,10 @@ class GoogleProvider(OAuthProxy):
             )
 
         # Apply defaults
-        base_url_final = settings.base_url or "http://localhost:8000"
         redirect_path_final = settings.redirect_path or "/auth/callback"
         timeout_seconds_final = settings.timeout_seconds or 10
         # Google requires at least one scope - openid is the minimal OIDC scope
         required_scopes_final = settings.required_scopes or ["openid"]
-        resource_server_url_final = settings.resource_server_url or base_url_final
         allowed_client_redirect_uris_final = settings.allowed_client_redirect_uris
 
         # Create Google token verifier
@@ -291,11 +285,10 @@ class GoogleProvider(OAuthProxy):
             upstream_client_id=settings.client_id,
             upstream_client_secret=client_secret_str,
             token_verifier=token_verifier,
-            base_url=base_url_final,
+            base_url=settings.base_url,
             redirect_path=redirect_path_final,
-            issuer_url=base_url_final,  # We act as the issuer for client registration
+            issuer_url=settings.base_url,  # We act as the issuer for client registration
             allowed_client_redirect_uris=allowed_client_redirect_uris_final,
-            resource_server_url=resource_server_url_final,
         )
 
         logger.info(

fastmcp/server/auth/providers/in_memory.py

@@ -41,7 +41,6 @@ class InMemoryOAuthProvider(OAuthProvider):
         client_registration_options: ClientRegistrationOptions | None = None,
         revocation_options: RevocationOptions | None = None,
         required_scopes: list[str] | None = None,
-        resource_server_url: AnyHttpUrl | str | None = None,
     ):
         super().__init__(
             base_url=base_url or "http://fastmcp.example.com",
@@ -49,7 +48,6 @@ class InMemoryOAuthProvider(OAuthProvider):
             client_registration_options=client_registration_options,
             revocation_options=revocation_options,
             required_scopes=required_scopes,
-            resource_server_url=resource_server_url,
         )
         self.clients: dict[str, OAuthClientInformationFull] = {}
         self.auth_codes: dict[str, AuthorizationCode] = {}

fastmcp/server/auth/providers/jwt.py

@@ -16,7 +16,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDict
 from typing_extensions import TypedDict
 
 from fastmcp.server.auth import AccessToken, TokenVerifier
-from fastmcp.server.auth.registry import register_provider
 from fastmcp.utilities.auth import parse_scopes
 from fastmcp.utilities.logging import get_logger
 from fastmcp.utilities.types import NotSet, NotSetT
@@ -154,7 +153,7 @@ class JWTVerifierSettings(BaseSettings):
     algorithm: str | None = None
     audience: str | list[str] | None = None
     required_scopes: list[str] | None = None
-    resource_server_url: AnyHttpUrl | str | None = None
+    base_url: AnyHttpUrl | str | None = None
 
     @field_validator("required_scopes", mode="before")
     @classmethod
@@ -162,7 +161,6 @@ class JWTVerifierSettings(BaseSettings):
         return parse_scopes(v)
 
 
-@register_provider("JWT")
 class JWTVerifier(TokenVerifier):
     """
     JWT token verifier supporting both asymmetric (RSA/ECDSA) and symmetric (HMAC) algorithms.
@@ -191,7 +189,7 @@ class JWTVerifier(TokenVerifier):
         audience: str | list[str] | None | NotSetT = NotSet,
         algorithm: str | None | NotSetT = NotSet,
         required_scopes: list[str] | None | NotSetT = NotSet,
-        resource_server_url: AnyHttpUrl | str | None | NotSetT = NotSet,
+        base_url: AnyHttpUrl | str | None | NotSetT = NotSet,
     ):
         """
         Initialize the JWT token verifier.
@@ -206,7 +204,7 @@ class JWTVerifier(TokenVerifier):
                       - Asymmetric: RS256/384/512, ES256/384/512, PS256/384/512 (default: RS256)
                       - Symmetric: HS256, HS384, HS512
             required_scopes: Required scopes for all tokens
-            resource_server_url: Resource server URL for TokenVerifier protocol
+            base_url: Base URL for TokenVerifier protocol
         """
         settings = JWTVerifierSettings.model_validate(
             {
@@ -218,7 +216,7 @@ class JWTVerifier(TokenVerifier):
                     "audience": audience,
                     "algorithm": algorithm,
                     "required_scopes": required_scopes,
-                    "resource_server_url": resource_server_url,
+                    "base_url": base_url,
                 }.items()
                 if v is not NotSet
             }
@@ -249,7 +247,7 @@ class JWTVerifier(TokenVerifier):
 
         # Initialize parent TokenVerifier
         super().__init__(
-            resource_server_url=settings.resource_server_url,
+            base_url=settings.base_url,
             required_scopes=settings.required_scopes,
         )
 

fastmcp/server/auth/providers/workos.py

@@ -10,6 +10,8 @@ Choose based on your WorkOS setup and authentication requirements.
 
 from __future__ import annotations
 
+from typing import Any
+
 import httpx
 from pydantic import AnyHttpUrl, SecretStr, field_validator
 from pydantic_settings import BaseSettings, SettingsConfigDict
@@ -19,7 +21,6 @@ from starlette.routing import Route
 from fastmcp.server.auth import AccessToken, RemoteAuthProvider, TokenVerifier
 from fastmcp.server.auth.oauth_proxy import OAuthProxy
 from fastmcp.server.auth.providers.jwt import JWTVerifier
-from fastmcp.server.auth.registry import register_provider
 from fastmcp.utilities.auth import parse_scopes
 from fastmcp.utilities.logging import get_logger
 from fastmcp.utilities.types import NotSet, NotSetT
@@ -43,7 +44,6 @@ class WorkOSProviderSettings(BaseSettings):
     redirect_path: str | None = None
     required_scopes: list[str] | None = None
     timeout_seconds: int | None = None
-    resource_server_url: AnyHttpUrl | str | None = None
     allowed_client_redirect_uris: list[str] | None = None
 
     @field_validator("required_scopes", mode="before")
@@ -124,7 +124,6 @@ class WorkOSTokenVerifier(TokenVerifier):
             return None
 
 
-@register_provider("WORKOS")
 class WorkOSProvider(OAuthProxy):
     """Complete WorkOS OAuth provider for FastMCP.
 
@@ -169,7 +168,6 @@ class WorkOSProvider(OAuthProxy):
         redirect_path: str | NotSetT = NotSet,
         required_scopes: list[str] | None | NotSetT = NotSet,
         timeout_seconds: int | NotSetT = NotSet,
-        resource_server_url: AnyHttpUrl | str | NotSetT = NotSet,
         allowed_client_redirect_uris: list[str] | NotSetT = NotSet,
     ):
         """Initialize WorkOS OAuth provider.
@@ -182,11 +180,10 @@ class WorkOSProvider(OAuthProxy):
             redirect_path: Redirect path configured in WorkOS (defaults to "/auth/callback")
             required_scopes: Required OAuth scopes (no default)
             timeout_seconds: HTTP request timeout for WorkOS API calls
-            resource_server_url: Path of the FastMCP server (defaults to base_url). If your MCP endpoint is at
-                a different path like {base_url}/mcp, specify it here for RFC 8707 compliance.
             allowed_client_redirect_uris: List of allowed redirect URI patterns for MCP clients.
                 If None (default), all URIs are allowed. If empty list, no URIs are allowed.
         """
+
         settings = WorkOSProviderSettings.model_validate(
             {
                 k: v
@@ -198,7 +195,6 @@ class WorkOSProvider(OAuthProxy):
                     "redirect_path": redirect_path,
                     "required_scopes": required_scopes,
                     "timeout_seconds": timeout_seconds,
-                    "resource_server_url": resource_server_url,
                     "allowed_client_redirect_uris": allowed_client_redirect_uris,
                 }.items()
                 if v is not NotSet
@@ -224,11 +220,9 @@ class WorkOSProvider(OAuthProxy):
         if not authkit_domain_str.startswith(("http://", "https://")):
             authkit_domain_str = f"https://{authkit_domain_str}"
         authkit_domain_final = authkit_domain_str.rstrip("/")
-        base_url_final = settings.base_url or "http://localhost:8000"
         redirect_path_final = settings.redirect_path or "/auth/callback"
         timeout_seconds_final = settings.timeout_seconds or 10
         scopes_final = settings.required_scopes or []
-        resource_server_url_final = settings.resource_server_url or base_url_final
         allowed_client_redirect_uris_final = settings.allowed_client_redirect_uris
 
         # Extract secret string from SecretStr
@@ -250,11 +244,10 @@ class WorkOSProvider(OAuthProxy):
             upstream_client_id=settings.client_id,
             upstream_client_secret=client_secret_str,
             token_verifier=token_verifier,
-            base_url=base_url_final,
+            base_url=settings.base_url,
             redirect_path=redirect_path_final,
-            issuer_url=base_url_final,
+            issuer_url=settings.base_url,
             allowed_client_redirect_uris=allowed_client_redirect_uris_final,
-            resource_server_url=resource_server_url_final,
         )
 
         logger.info(
@@ -281,7 +274,6 @@ class AuthKitProviderSettings(BaseSettings):
         return parse_scopes(v)
 
 
-@register_provider("AUTHKIT")
 class AuthKitProvider(RemoteAuthProvider):
     """AuthKit metadata provider for DCR (Dynamic Client Registration).
 
@@ -362,17 +354,25 @@ class AuthKitProvider(RemoteAuthProvider):
         super().__init__(
             token_verifier=token_verifier,
             authorization_servers=[AnyHttpUrl(self.authkit_domain)],
-            resource_server_url=self.base_url,
+            base_url=self.base_url,
         )
 
-    def get_routes(self) -> list[Route]:
+    def get_routes(
+        self,
+        mcp_path: str | None = None,
+        mcp_endpoint: Any | None = None,
+    ) -> list[Route]:
         """Get OAuth routes including AuthKit authorization server metadata forwarding.
 
         This returns the standard protected resource routes plus an authorization server
         metadata endpoint that forwards AuthKit's OAuth metadata to clients.
+
+        Args:
+            mcp_path: The path where the MCP endpoint is mounted (e.g., "/mcp")
+            mcp_endpoint: The MCP endpoint handler to protect with auth
         """
         # Get the standard protected resource routes from RemoteAuthProvider
-        routes = super().get_routes()
+        routes = super().get_routes(mcp_path, mcp_endpoint)
 
         async def oauth_authorization_server_metadata(request):
             """Forward AuthKit OAuth authorization server metadata with FastMCP customizations."""

fastmcp/server/context.py

@@ -10,7 +10,7 @@ from contextlib import contextmanager
 from contextvars import ContextVar, Token
 from dataclasses import dataclass
 from enum import Enum
-from typing import Any, Literal, TypeVar, cast, get_origin, overload
+from typing import Any, Literal, cast, get_origin, overload
 
 from mcp import LoggingLevel, ServerSession
 from mcp.server.lowlevel.helper_types import ReadResourceContents
@@ -31,6 +31,7 @@ from mcp.types import (
 from mcp.types import CreateMessageRequestParams as SamplingParams
 from pydantic.networks import AnyUrl
 from starlette.requests import Request
+from typing_extensions import TypeVar
 
 import fastmcp.server.dependencies
 from fastmcp import settings
@@ -47,7 +48,7 @@ from fastmcp.utilities.types import get_cached_typeadapter
 
 logger = get_logger(__name__)
 
-T = TypeVar("T")
+T = TypeVar("T", default=Any)
 _current_context: ContextVar[Context | None] = ContextVar("context", default=None)  # type: ignore[assignment]
 _flush_lock = asyncio.Lock()
 

fastmcp/server/dependencies.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, ParamSpec, TypeVar
+from typing import TYPE_CHECKING
 
 from mcp.server.auth.middleware.auth_context import (
     get_access_token as _sdk_get_access_token,
@@ -12,9 +12,6 @@ from fastmcp.server.auth import AccessToken
 if TYPE_CHECKING:
     from fastmcp.server.context import Context
 
-P = ParamSpec("P")
-R = TypeVar("R")
-
 __all__ = [
     "get_context",
     "get_http_request",

fastmcp/server/elicitation.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Any, Generic, Literal, TypeVar
+from typing import Any, Generic, Literal
 
 from mcp.server.elicitation import (
     CancelledElicitation,
@@ -10,6 +10,7 @@ from mcp.server.elicitation import (
 from pydantic import BaseModel
 from pydantic.json_schema import GenerateJsonSchema, JsonSchemaValue
 from pydantic_core import core_schema
+from typing_extensions import TypeVar
 
 from fastmcp.utilities.json_schema import compress_schema
 from fastmcp.utilities.logging import get_logger
@@ -25,7 +26,7 @@ __all__ = [
 
 logger = get_logger(__name__)
 
-T = TypeVar("T")
+T = TypeVar("T", default=Any)
 
 
 class ElicitationJsonSchema(GenerateJsonSchema):

fastmcp/server/http.py

@@ -3,21 +3,15 @@ from __future__ import annotations
 from collections.abc import AsyncGenerator, Callable, Generator
 from contextlib import asynccontextmanager, contextmanager
 from contextvars import ContextVar
-from typing import TYPE_CHECKING, cast
+from typing import TYPE_CHECKING
 
-from mcp.server.auth.middleware.auth_context import AuthContextMiddleware
-from mcp.server.auth.middleware.bearer_auth import (
-    BearerAuthBackend,
-    RequireAuthMiddleware,
-)
-from mcp.server.auth.provider import TokenVerifier as TokenVerifierProtocol
+from mcp.server.auth.middleware.bearer_auth import RequireAuthMiddleware
 from mcp.server.lowlevel.server import LifespanResultT
 from mcp.server.sse import SseServerTransport
 from mcp.server.streamable_http import EventStore
 from mcp.server.streamable_http_manager import StreamableHTTPSessionManager
 from starlette.applications import Starlette
 from starlette.middleware import Middleware
-from starlette.middleware.authentication import AuthenticationMiddleware
 from starlette.requests import Request
 from starlette.responses import Response
 from starlette.routing import BaseRoute, Mount, Route
@@ -170,40 +164,26 @@ def create_sse_app(
 
     # Set up auth if enabled
     if auth:
-        # Create auth middleware
-        auth_middleware = [
-            Middleware(
-                AuthenticationMiddleware,
-                backend=BearerAuthBackend(auth),
-            ),
-            Middleware(AuthContextMiddleware),
-        ]
-
-        # Get auth routes and scopes
-        auth_routes = auth.get_routes()
-        required_scopes = getattr(auth, "required_scopes", None) or []
-
-        # Get resource metadata URL for WWW-Authenticate header
-        resource_metadata_url = auth.get_resource_metadata_url()
+        # Get auth middleware from the provider
+        auth_middleware = auth.get_middleware()
+
+        # Get auth routes including protected MCP endpoint
+        auth_routes = auth.get_routes(
+            mcp_path=sse_path,
+            mcp_endpoint=handle_sse,
+        )
 
         server_routes.extend(auth_routes)
         server_middleware.extend(auth_middleware)
 
-        # Auth is enabled, wrap endpoints with RequireAuthMiddleware
-        server_routes.append(
-            Route(
-                sse_path,
-                endpoint=RequireAuthMiddleware(
-                    handle_sse, required_scopes, resource_metadata_url
-                ),
-                methods=["GET"],
-            )
-        )
+        # Manually wrap the SSE message endpoint with RequireAuthMiddleware
         server_routes.append(
             Mount(
                 message_path,
                 app=RequireAuthMiddleware(
-                    sse.handle_post_message, required_scopes, resource_metadata_url
+                    sse.handle_post_message,
+                    auth.required_scopes,
+                    auth._get_resource_url("/.well-known/oauth-protected-resource"),
                 ),
             )
         )
@@ -291,34 +271,17 @@ def create_streamable_http_app(
 
     # Add StreamableHTTP routes with or without auth
     if auth:
-        # Create auth middleware
-        auth_middleware = [
-            Middleware(
-                AuthenticationMiddleware,
-                backend=BearerAuthBackend(cast(TokenVerifierProtocol, auth)),
-            ),
-            Middleware(AuthContextMiddleware),
-        ]
-
-        # Get auth routes and scopes
-        auth_routes = auth.get_routes()
-        required_scopes = getattr(auth, "required_scopes", None) or []
-
-        # Get resource metadata URL for WWW-Authenticate header
-        resource_metadata_url = auth.get_resource_metadata_url()
+        # Get auth middleware from the provider
+        auth_middleware = auth.get_middleware()
+
+        # Get auth routes including protected MCP endpoint
+        auth_routes = auth.get_routes(
+            mcp_path=streamable_http_path,
+            mcp_endpoint=streamable_http_app,
+        )
 
         server_routes.extend(auth_routes)
         server_middleware.extend(auth_middleware)
-
-        # Auth is enabled, wrap endpoint with RequireAuthMiddleware
-        server_routes.append(
-            Route(
-                streamable_http_path,
-                endpoint=RequireAuthMiddleware(
-                    streamable_http_app, required_scopes, resource_metadata_url
-                ),
-            )
-        )
     else:
         # No auth required
         server_routes.append(

fastmcp/server/middleware/middleware.py

@@ -11,11 +11,11 @@ from typing import (
     Generic,
     Literal,
     Protocol,
-    TypeVar,
     runtime_checkable,
 )
 
 import mcp.types as mt
+from typing_extensions import TypeVar
 
 from fastmcp.prompts.prompt import Prompt
 from fastmcp.resources.resource import Resource
@@ -34,8 +34,8 @@ __all__ = [
 logger = logging.getLogger(__name__)
 
 
-T = TypeVar("T")
-R = TypeVar("R", covariant=True)
+T = TypeVar("T", default=Any)
+R = TypeVar("R", covariant=True, default=Any)
 
 
 @runtime_checkable

fastmcp/server/server.py

@@ -52,7 +52,6 @@ from fastmcp.prompts.prompt import FunctionPrompt
 from fastmcp.resources import Resource, ResourceManager
 from fastmcp.resources.template import ResourceTemplate
 from fastmcp.server.auth import AuthProvider
-from fastmcp.server.auth.registry import get_registered_provider
 from fastmcp.server.http import (
     StarletteWithLifespan,
     create_sse_app,
@@ -209,8 +208,8 @@ class FastMCP(Generic[LifespanResultT]):
         # if auth is `NotSet`, try to create a provider from the environment
         if auth is NotSet:
             if fastmcp.settings.server_auth is not None:
-                provider_cls = get_registered_provider(fastmcp.settings.server_auth)
-                auth = provider_cls()
+                # ImportString returns the class itself
+                auth = fastmcp.settings.server_auth()
             else:
                 auth = None
         self.auth = cast(AuthProvider | None, auth)

fastmcp/settings.py

@@ -5,7 +5,7 @@ import warnings
 from pathlib import Path
 from typing import Annotated, Any, Literal
 
-from pydantic import Field, field_validator
+from pydantic import Field, ImportString, field_validator
 from pydantic.fields import FieldInfo
 from pydantic_settings import (
     BaseSettings,
@@ -258,14 +258,17 @@ class Settings(BaseSettings):
 
     # Auth settings
     server_auth: Annotated[
-        str | None,
+        ImportString | None,
         Field(
             description=inspect.cleandoc(
                 """
-                Configure the authentication provider for the server. Auth
-                providers are registered with a specific key, and providing that
-                key here will cause the server to automatically configure the
-                provider from the environment.
+                Configure the authentication provider for the server by specifying
+                the full module path to an AuthProvider class (e.g., 
+                'fastmcp.server.auth.providers.google.GoogleProvider').
+
+                The specified class will be imported and instantiated automatically.
+                Any class that inherits from AuthProvider can be used, including
+                custom implementations.
 
                 If None, no automatic configuration will take place.
 
@@ -274,6 +277,11 @@ class Settings(BaseSettings):
 
                 Note that most auth providers require additional configuration
                 that must be provided via env vars.
+
+                Examples:
+                  - fastmcp.server.auth.providers.google.GoogleProvider
+                  - fastmcp.server.auth.providers.jwt.JWTVerifier
+                  - mycompany.auth.CustomAuthProvider
                 """
             ),
         ),

fastmcp/tools/tool.py

@@ -10,7 +10,6 @@ from typing import (
     Any,
     Generic,
     Literal,
-    TypeVar,
     get_type_hints,
 )
 
@@ -19,6 +18,7 @@ import pydantic_core
 from mcp.types import ContentBlock, TextContent, ToolAnnotations
 from mcp.types import Tool as MCPTool
 from pydantic import Field, PydanticSchemaGenerationError
+from typing_extensions import TypeVar
 
 import fastmcp
 from fastmcp.server.dependencies import get_context
@@ -41,7 +41,7 @@ if TYPE_CHECKING:
 
 logger = get_logger(__name__)
 
-T = TypeVar("T")
+T = TypeVar("T", default=Any)
 
 
 @dataclass

fastmcp/utilities/components.py

@@ -1,15 +1,15 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
-from typing import Annotated, Any, TypedDict, TypeVar
+from typing import Annotated, Any, TypedDict
 
 from pydantic import BeforeValidator, Field, PrivateAttr
-from typing_extensions import Self
+from typing_extensions import Self, TypeVar
 
 import fastmcp
 from fastmcp.utilities.types import FastMCPBaseModel
 
-T = TypeVar("T")
+T = TypeVar("T", default=Any)
 
 
 class FastMCPMeta(TypedDict, total=False):

fastmcp/utilities/mcp_server_config/v1/mcp_server_config.py

@@ -36,7 +36,7 @@ EnvironmentType: TypeAlias = UVEnvironment
 class Deployment(BaseModel):
     """Configuration for server deployment and runtime settings."""
 
-    transport: Literal["stdio", "http", "sse"] | None = Field(
+    transport: Literal["stdio", "http", "sse", "streamable-http"] | None = Field(
         default=None,
         description="Transport protocol to use",
     )
@@ -184,7 +184,7 @@ class MCPServerConfig(BaseModel):
         """Validate and convert source to proper format.
 
         Supports:
-        - Dict format: {"path": "server.py", "entrypoint": "app"}
+        - Dict format: `{"path": "server.py", "entrypoint": "app"}`
         - FileSystemSource instance (passed through)
 
         No string parsing happens here - that's only at CLI boundaries.

fastmcp/utilities/types.py

@@ -13,7 +13,6 @@ from typing import (
     Any,
     Protocol,
     TypeAlias,
-    TypeVar,
     Union,
     get_args,
     get_origin,
@@ -23,8 +22,9 @@ from typing import (
 import mcp.types
 from mcp.types import Annotations, ContentBlock, ModelPreferences, SamplingMessage
 from pydantic import AnyUrl, BaseModel, ConfigDict, Field, TypeAdapter, UrlConstraints
+from typing_extensions import TypeVar
 
-T = TypeVar("T")
+T = TypeVar("T", default=Any)
 
 # sentinel values for optional arguments
 NotSet = ...

{fastmcp-2.12.0rc1.dist-info → fastmcp-2.12.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastmcp
-Version: 2.12.0rc1
+Version: 2.12.2
 Summary: The fast, Pythonic way to build MCP servers and clients.
 Project-URL: Homepage, https://gofastmcp.com
 Project-URL: Repository, https://github.com/jlowin/fastmcp
@@ -22,13 +22,14 @@ Requires-Dist: cyclopts>=3.0.0
 Requires-Dist: exceptiongroup>=1.2.2
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: mcp<2.0.0,>=1.12.4
-Requires-Dist: openai>=1.95.1
 Requires-Dist: openapi-core>=0.19.5
 Requires-Dist: openapi-pydantic>=0.5.1
 Requires-Dist: pydantic[email]>=2.11.7
 Requires-Dist: pyperclip>=1.9.0
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: rich>=13.9.4
+Provides-Extra: openai
+Requires-Dist: openai>=1.102.0; extra == 'openai'
 Provides-Extra: websockets
 Requires-Dist: websockets>=15.0.1; extra == 'websockets'
 Description-Content-Type: text/markdown