Add quickstart-server example for the "Building MCP servers" tutorial

Import the weather server from the external `quickstart-resources` repo
into `examples/servers/quickstart-server/`, adapting it for the
monorepo.

The layout uses a top-level `weather.py` script with a stub
`mcp_quickstart_server/` package for hatchling, keeping the code
faithful to what the tutorial guide shows readers.

Changes from the original:

- `FastMCP` → `MCPServer` (renamed in the SDK)
- `mcp[cli]` → plain `mcp` (CLI extras not needed at runtime)
- Bare `dict` → `dict[str, Any]` for type safety
- Added `list[str]` annotation and `-> None` return type for pyright

Author: jonathanhefner

examples/servers/quickstart-server/README.md

@@ -0,0 +1,3 @@
+# A Weather MCP Server
+
+See the [Build an MCP server](https://modelcontextprotocol.io/docs/develop/build-server) tutorial for more information.

examples/servers/quickstart-server/mcp_quickstart_server/__init__.py

@@ -0,0 +1,24 @@
+[project]
+name = "mcp-quickstart-server"
+version = "0.1.0"
+description = "Tutorial companion: a weather MCP server using the NWS API"
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.27",
+    "mcp",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["mcp_quickstart_server"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+ignore = []

examples/servers/quickstart-server/pyproject.toml

@@ -0,0 +1,101 @@
+from typing import Any
+
+import httpx
+from mcp.server.mcpserver import MCPServer
+
+# Initialize MCP server
+mcp = MCPServer("weather")
+
+# Constants
+NWS_API_BASE = "https://api.weather.gov"
+USER_AGENT = "weather-app/1.0"
+
+
+async def make_nws_request(url: str) -> dict[str, Any] | None:
+    """Make a request to the NWS API with proper error handling."""
+    headers = {"User-Agent": USER_AGENT, "Accept": "application/geo+json"}
+    async with httpx.AsyncClient() as client:
+        try:
+            response = await client.get(url, headers=headers, timeout=30.0)
+            response.raise_for_status()
+            return response.json()
+        except Exception:
+            return None
+
+
+def format_alert(feature: dict[str, Any]) -> str:
+    """Format an alert feature into a readable string."""
+    props = feature["properties"]
+    return f"""
+Event: {props.get("event", "Unknown")}
+Area: {props.get("areaDesc", "Unknown")}
+Severity: {props.get("severity", "Unknown")}
+Description: {props.get("description", "No description available")}
+Instructions: {props.get("instruction", "No specific instructions provided")}
+"""
+
+
+@mcp.tool()
+async def get_alerts(state: str) -> str:
+    """Get weather alerts for a US state.
+
+    Args:
+        state: Two-letter US state code (e.g. CA, NY)
+    """
+    url = f"{NWS_API_BASE}/alerts/active/area/{state}"
+    data = await make_nws_request(url)
+
+    if not data or "features" not in data:
+        return "Unable to fetch alerts or no alerts found."
+
+    if not data["features"]:
+        return "No active alerts for this state."
+
+    alerts = [format_alert(feature) for feature in data["features"]]
+    return "\n---\n".join(alerts)
+
+
+@mcp.tool()
+async def get_forecast(latitude: float, longitude: float) -> str:
+    """Get weather forecast for a location.
+
+    Args:
+        latitude: Latitude of the location
+        longitude: Longitude of the location
+    """
+    # First get the forecast grid endpoint
+    points_url = f"{NWS_API_BASE}/points/{latitude},{longitude}"
+    points_data = await make_nws_request(points_url)
+
+    if not points_data:
+        return "Unable to fetch forecast data for this location."
+
+    # Get the forecast URL from the points response
+    forecast_url = points_data["properties"]["forecast"]
+    forecast_data = await make_nws_request(forecast_url)
+
+    if not forecast_data:
+        return "Unable to fetch detailed forecast."
+
+    # Format the periods into a readable forecast
+    periods = forecast_data["properties"]["periods"]
+    forecasts: list[str] = []
+    for period in periods[:5]:  # Only show next 5 periods
+        forecast = f"""
+{period["name"]}:
+Temperature: {period["temperature"]}°{period["temperatureUnit"]}
+Wind: {period["windSpeed"]} {period["windDirection"]}
+Forecast: {period["detailedForecast"]}
+"""
+        forecasts.append(forecast)
+
+    return "\n---\n".join(forecasts)
+
+
+def main() -> None:
+    """Run the weather MCP server."""
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()