Get rid of silly TS comments

Author: praboud-ant

src/mcp/server/auth/errors.py

@@ -1,9 +1,3 @@
-"""
-OAuth error classes for MCP authorization.
-
-Corresponds to TypeScript file: src/server/auth/errors.ts
-"""
-
 from typing import Literal
 
 from pydantic import BaseModel, ValidationError
@@ -19,8 +13,6 @@ class ErrorResponse(BaseModel):
 class OAuthError(Exception):
     """
     Base class for all OAuth errors.
-
-    Corresponds to OAuthError in src/server/auth/errors.ts
     """
 
     error_code: ErrorCode
@@ -39,8 +31,6 @@ def error_response(self) -> ErrorResponse:
 class InvalidRequestError(OAuthError):
     """
     Invalid request error.
-
-    Corresponds to InvalidRequestError in src/server/auth/errors.ts
     """
 
     error_code = "invalid_request"
@@ -49,8 +39,6 @@ class InvalidRequestError(OAuthError):
 class InvalidClientError(OAuthError):
     """
     Invalid client error.
-
-    Corresponds to InvalidClientError in src/server/auth/errors.ts
     """
 
     error_code = "invalid_client"

src/mcp/server/auth/handlers/authorize.py

@@ -1,9 +1,3 @@
-"""
-Handler for OAuth 2.0 Authorization endpoint.
-
-Corresponds to TypeScript file: src/server/auth/handlers/authorize.ts
-"""
-
 import logging
 from dataclasses import dataclass
 from typing import Literal

src/mcp/server/auth/handlers/metadata.py

@@ -1,9 +1,3 @@
-"""
-Handler for OAuth 2.0 Authorization Server Metadata.
-
-Corresponds to TypeScript file: src/server/auth/handlers/metadata.ts
-"""
-
 from dataclasses import dataclass
 from typing import Any
 

src/mcp/server/auth/handlers/register.py

@@ -1,9 +1,3 @@
-"""
-Handler for OAuth 2.0 Dynamic Client Registration.
-
-Corresponds to TypeScript file: src/server/auth/handlers/register.ts
-"""
-
 import secrets
 import time
 from dataclasses import dataclass

src/mcp/server/auth/handlers/revoke.py

@@ -1,9 +1,3 @@
-"""
-Handler for OAuth 2.0 Token Revocation.
-
-Corresponds to TypeScript file: src/server/auth/handlers/revoke.ts
-"""
-
 from dataclasses import dataclass
 from typing import Literal
 

src/mcp/server/auth/handlers/token.py

@@ -1,9 +1,3 @@
-"""
-Handler for OAuth 2.0 Token endpoint.
-
-Corresponds to TypeScript file: src/server/auth/handlers/token.ts
-"""
-
 import base64
 import hashlib
 import time

src/mcp/server/auth/middleware/bearer_auth.py

@@ -1,9 +1,3 @@
-"""
-Bearer token authentication middleware for ASGI applications.
-
-Corresponds to TypeScript file: src/server/auth/middleware/bearerAuth.ts
-"""
-
 import time
 from typing import Any, Callable
 
@@ -65,8 +59,6 @@ class RequireAuthMiddleware:
 
     This will validate the token with the auth provider and store the resulting
     auth info in the request state.
-
-    Corresponds to bearerAuthMiddleware in src/server/auth/middleware/bearerAuth.ts
     """
 
     def __init__(self, app: Any, required_scopes: list[str]):

src/mcp/server/auth/middleware/client_auth.py

@@ -1,9 +1,3 @@
-"""
-Client authentication middleware for ASGI applications.
-
-Corresponds to TypeScript file: src/server/auth/middleware/clientAuth.ts
-"""
-
 import time
 
 from pydantic import BaseModel
@@ -14,12 +8,7 @@
 
 
 class ClientAuthRequest(BaseModel):
-    """
-    Model for client authentication request body.
-
-    Corresponds to ClientAuthenticatedRequestSchema in
-    src/server/auth/middleware/clientAuth.ts
-    """
+    # TODO: mix this directly into TokenRequest
 
     client_id: str
     client_secret: str | None = None

src/mcp/server/auth/router.py

@@ -1,9 +1,3 @@
-"""
-Router for OAuth authorization endpoints.
-
-Corresponds to TypeScript file: src/server/auth/router.ts
-"""
-
 from dataclasses import dataclass
 from typing import Any
 
@@ -72,8 +66,6 @@ def create_auth_router(
     """
     Create a Starlette router with standard MCP authorization endpoints.
 
-    Corresponds to mcpAuthRouter in src/server/auth/router.ts
-
     Args:
         provider: OAuth server provider
         issuer_url: Issuer URL for the authorization server

src/mcp/server/auth/types.py

@@ -1,19 +1,7 @@
-"""
-Authorization types for MCP server.
-
-Corresponds to TypeScript file: src/server/auth/types.ts
-"""
-
 from pydantic import BaseModel
 
 
 class AuthInfo(BaseModel):
-    """
-    Information about a validated access token, provided to request handlers.
-
-    Corresponds to AuthInfo in src/server/auth/types.ts
-    """
-
     token: str
     client_id: str
     scopes: list[str]

src/mcp/shared/auth.py

@@ -1,9 +1,3 @@
-"""
-Authorization types and models for MCP OAuth implementation.
-
-Corresponds to TypeScript file: src/shared/auth.ts
-"""
-
 from typing import Any, List, Literal, Optional
 
 from pydantic import AnyHttpUrl, BaseModel, Field
@@ -60,8 +54,6 @@ class OAuthClientMetadata(BaseModel):
 class OAuthClientInformation(BaseModel):
     """
     RFC 7591 OAuth 2.0 Dynamic Client Registration client information.
-
-    Corresponds to OAuthClientInformationSchema in src/shared/auth.ts
     """
 
     client_id: str
@@ -74,8 +66,6 @@ class OAuthClientInformationFull(OAuthClientMetadata, OAuthClientInformation):
     """
     RFC 7591 OAuth 2.0 Dynamic Client Registration full response
     (client information plus metadata).
-
-    Corresponds to OAuthClientInformationFullSchema in src/shared/auth.ts
     """
 
     pass
@@ -84,8 +74,6 @@ class OAuthClientInformationFull(OAuthClientMetadata, OAuthClientInformation):
 class OAuthClientRegistrationError(BaseModel):
     """
     RFC 7591 OAuth 2.0 Dynamic Client Registration error response.
-
-    Corresponds to OAuthClientRegistrationErrorSchema in src/shared/auth.ts
     """
 
     error: str
@@ -95,8 +83,6 @@ class OAuthClientRegistrationError(BaseModel):
 class OAuthMetadata(BaseModel):
     """
     RFC 8414 OAuth 2.0 Authorization Server Metadata.
-
-    Corresponds to OAuthMetadataSchema in src/shared/auth.ts
     """
 
     issuer: str