# 1. Clone or download this folder
cd demo/

# 2. (Optional) Create a virtual environment
python -m venv .venv
source .venv/bin/activate        # macOS / Linux
.venv\Scripts\activate           # Windows

# 3. Install the MCP SDK
pip install -r requirements.txt

# 4. Run the server
python weather_server.py

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/full/path/to/demo/weather_server.py"]
    }
  }
}

🌍 Weather in Tokyo:
🌡️  Temperature: 18°C
☁️  Condition:   Clear
💧 Humidity:    55%
💨 Wind:        10 km/h NE

import httpx

async def fetch_live_weather(city: str) -> dict:
    url = f"https://api.openweathermap.org/data/2.5/weather"
    params = {"q": city, "appid": "YOUR_API_KEY", "units": "metric"}
    async with httpx.AsyncClient() as client:
        resp = await client.get(url, params=params)
        data = resp.json()
        return {
            "temp": data["main"]["temp"],
            "condition": data["weather"][0]["description"].title(),
            "humidity": data["main"]["humidity"],
            "wind": f"{data['wind']['speed']} m/s"
        }

demo/
├── weather_server.py   # MCP server — all logic here
├── requirements.txt    # pip install mcp
└── README.md           # This file

Claude Desktop (Host)
    └── MCP Client (built into host)
            └── MCP Protocol (JSON-RPC 2.0 over stdio)
                    └── weather_server.py (YOUR server)
                            └── Returns weather data