refactor: move stdio package to its own module

Author: Kludex

src/mcp/client/__init__.py

@@ -3,7 +3,4 @@
 from mcp.client.client import Client
 from mcp.client.session import ClientSession
 
-__all__ = [
-    "Client",
-    "ClientSession",
-]
+__all__ = ["Client", "ClientSession"]

src/mcp/client/client.py

@@ -66,7 +66,10 @@ def __init__(
         self,
         server: Server[Any] | FastMCP,
         *,
-        # TODO(Marcelo): When do `raise_exceptions=True` actually raises?
+        # Note: raise_exceptions only affects transport/stream errors and exceptions
+        # that escape request handlers. Tool exceptions in FastMCP are caught by
+        # the call_tool decorator and converted to error results. See test_client.py
+        # test_raise_exceptions_returns_error_result_for_tool_exceptions for details.
         raise_exceptions: bool = False,
         read_timeout_seconds: float | None = None,
         sampling_callback: SamplingFnT | None = None,

src/mcp/client/session_group.py

@@ -30,7 +30,7 @@
 
 
 class SseServerParameters(BaseModel):
-    """Parameters for intializing a sse_client."""
+    """Parameters for initializing a sse_client."""
 
     # The endpoint URL.
     url: str
@@ -46,7 +46,7 @@ class SseServerParameters(BaseModel):
 
 
 class StreamableHttpParameters(BaseModel):
-    """Parameters for intializing a streamable_http_client."""
+    """Parameters for initializing a streamable_http_client."""
 
     # The endpoint URL.
     url: str

src/mcp/client/stdio/__init__.py src/mcp/client/stdio.pysrc/mcp/client/stdio/__init__.py renamed to src/mcp/client/stdio.py

@@ -8,7 +8,7 @@
 from websockets.asyncio.client import connect as ws_connect
 from websockets.typing import Subprotocol
 
-import mcp.types as types
+from mcp import types
 from mcp.shared.message import SessionMessage