Revert "Remove the examples' pydantic-settings usage instead of carrying the dependency"

This reverts commit c752b0e.

Author: maxisbey

examples/mcpserver/text_me.py

@@ -0,0 +1,67 @@
+# /// script
+# dependencies = []
+# ///
+
+"""MCPServer Text Me Server
+--------------------------------
+This defines a simple MCPServer server that sends a text message to a phone number via https://surgemsg.com/.
+
+To run this example, create a `.env` file with the following values:
+
+SURGE_API_KEY=...
+SURGE_ACCOUNT_ID=...
+SURGE_MY_PHONE_NUMBER=...
+SURGE_MY_FIRST_NAME=...
+SURGE_MY_LAST_NAME=...
+
+Visit https://surgemsg.com/ and click "Get Started" to obtain these values.
+"""
+
+from typing import Annotated
+
+import httpx2
+from pydantic import BeforeValidator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+from mcp.server.mcpserver import MCPServer
+
+
+class SurgeSettings(BaseSettings):
+    model_config: SettingsConfigDict = SettingsConfigDict(env_prefix="SURGE_", env_file=".env")
+
+    api_key: str
+    account_id: str
+    my_phone_number: Annotated[str, BeforeValidator(lambda v: "+" + v if not v.startswith("+") else v)]
+    my_first_name: str
+    my_last_name: str
+
+
+# Create server
+mcp = MCPServer("Text me")
+surge_settings = SurgeSettings()  # type: ignore
+
+
+@mcp.tool(name="textme", description="Send a text message to me")
+def text_me(text_content: str) -> str:
+    """Send a text message to a phone number via https://surgemsg.com/"""
+    with httpx2.Client() as client:
+        response = client.post(
+            "https://api.surgemsg.com/messages",
+            headers={
+                "Authorization": f"Bearer {surge_settings.api_key}",
+                "Surge-Account": surge_settings.account_id,
+                "Content-Type": "application/json",
+            },
+            json={
+                "body": text_content,
+                "conversation": {
+                    "contact": {
+                        "first_name": surge_settings.my_first_name,
+                        "last_name": surge_settings.my_last_name,
+                        "phone_number": surge_settings.my_phone_number,
+                    }
+                },
+            },
+        )
+        response.raise_for_status()
+        return f"Message sent: {text_content}"

examples/servers/simple-auth/mcp_simple_auth/server.py

@@ -12,7 +12,8 @@
 from typing import Any, Literal
 
 import click
-from pydantic import AnyHttpUrl, BaseModel
+from pydantic import AnyHttpUrl
+from pydantic_settings import BaseSettings, SettingsConfigDict
 
 from mcp.server.auth.settings import AuthSettings
 from mcp.server.mcpserver.server import MCPServer
@@ -22,9 +23,11 @@
 logger = logging.getLogger(__name__)
 
 
-class ResourceServerSettings(BaseModel):
+class ResourceServerSettings(BaseSettings):
     """Settings for the MCP Resource Server."""
 
+    model_config = SettingsConfigDict(env_prefix="MCP_RESOURCE_")
+
     # Server settings
     host: str = "localhost"
     port: int = 8001

examples/servers/simple-auth/mcp_simple_auth/simple_auth_provider.py

@@ -12,7 +12,8 @@
 import time
 from typing import Any
 
-from pydantic import AnyHttpUrl, BaseModel
+from pydantic import AnyHttpUrl
+from pydantic_settings import BaseSettings, SettingsConfigDict
 from starlette.exceptions import HTTPException
 from starlette.requests import Request
 from starlette.responses import HTMLResponse, RedirectResponse, Response
@@ -28,9 +29,11 @@
 from mcp.shared.auth import OAuthClientInformationFull, OAuthToken
 
 
-class SimpleAuthSettings(BaseModel):
+class SimpleAuthSettings(BaseSettings):
     """Simple OAuth settings for demo purposes."""
 
+    model_config = SettingsConfigDict(env_prefix="MCP_")
+
     # Demo user credentials
     demo_username: str = "demo_user"
     demo_password: str = "demo_password"

examples/servers/simple-auth/pyproject.toml

@@ -12,6 +12,7 @@ dependencies = [
     "httpx2>=2.5.0",
     "mcp",
     "pydantic>=2.0",
+    "pydantic-settings>=2.5.2",
     "sse-starlette>=1.6.1",
     "uvicorn>=0.23.1; sys_platform != 'emscripten'",
 ]

pyproject.toml

@@ -58,6 +58,9 @@ dev = [
     # We add mcp[cli] so `uv sync` considers the extras.
     "mcp[cli]",
     "mcp-example-stories",
+    # pydantic-settings is used only by examples (simple-auth, mcpserver/text_me);
+    # keep it reachable for pyright, which covers examples/servers.
+    "pydantic-settings>=2.5.2",
     "tomli>=2.0; python_version < '3.11'",
     "pyright>=1.1.400",
     "pytest>=8.4.0",