Add overload for deprecation

Author: Kludex

src/mcp/client/streamable_http.py

@@ -12,6 +12,8 @@
 from contextlib import asynccontextmanager
 from dataclasses import dataclass
 from datetime import timedelta
+from typing import Any, overload
+from warnings import warn
 
 import anyio
 import httpx
@@ -85,13 +87,28 @@ class RequestContext:
 class StreamableHTTPTransport:
     """StreamableHTTP client transport implementation."""
 
+    @overload
+    def __init__(self, url: str) -> None: ...
+
+    @deprecated("Those parameters are deprecated. Use the url parameter instead.")
+    @overload
+    def __init__(
+        self,
+        url: str,
+        headers: dict[str, str] | None = None,
+        timeout: float | timedelta = 30,
+        sse_read_timeout: float | timedelta = 60 * 5,
+        auth: httpx.Auth | None = None,
+    ) -> None: ...
+
     def __init__(
         self,
         url: str,
         headers: dict[str, str] | None = None,
         timeout: float | timedelta = 30,
         sse_read_timeout: float | timedelta = 60 * 5,
         auth: httpx.Auth | None = None,
+        **deprecated: dict[str, Any],
     ) -> None:
         """Initialize the StreamableHTTP transport.
 
@@ -102,6 +119,8 @@ def __init__(
             sse_read_timeout: Timeout for SSE read operations.
             auth: Optional HTTPX authentication handler.
         """
+        if deprecated:
+            warn(f"Deprecated parameters: {deprecated}", DeprecationWarning)
         self.url = url
         self.headers = headers or {}
         self.timeout = timeout.total_seconds() if isinstance(timeout, timedelta) else timeout