---

The background reacts to two things at once — the time of day and the weather. The sky palette follows each city's real sunrise/sunset (🌅 dawn glows peach, ☀️ day is blue-and-gold, 🌆 dusk turns purple-orange, 🌙 night dims to indigo), and the weather tints it on top (🌧️ rain cools it blue, ❄️ snow turns icy, ⛈️ storms go deep purple, ☁️ overcast mutes to grey). It cross-fades when you switch cities.

✨ Widgets

Tool	Shows
show_weather	Current-conditions card — big temp, animated icon, feels-like, today's high/low, 6-stat grid
show_weather_forecast	7-day grid with icons, precip chance and high→low range bars
show_weather_hourly	Next-24h strip with an SVG temperature curve
show_weather_dashboard	Everything at once — current + hourly + 7-day + extra stats
get_weather	Plain JSON (current + hourly + daily), no widget

Every widget has city chips to switch locations instantly and a live °F / °C toggle.

🚀 Run it

uv sync
uv run python server/server.py        # → http://localhost:8778/mcp

Point your MCP host at http://localhost:8778/mcp. No key, no signup.

⚙️ Configure (all optional)

Env var	Default	Meaning
WEATHER_CITIES	San Francisco,New York,London,Tokyo,Sydney,Paris	The city chips
WEATHER_UNITS	imperial	Default units (imperial / metric)
WEATHER_CACHE_TTL	600	Forecast cache seconds (0 disables)
WEATHER_PREFETCH	off	all = fetch every city up front

One tool call fetches only the active city (≤2 requests) and caches it, so you stay well under Open-Meteo's free rate limit. Other chips warm from cache.

☁️ Deploy

Render — push to GitHub, then New → Blueprint (uses the bundled render.yaml). No env vars needed.

Docker

docker build -t es-weather-mcp . && docker run -p 8080:8080 es-weather-mcp

Azure Container Apps — one command via the bundled Bicep (infra/) + azure.yaml:

azd up        # provision + build + deploy  →  prints the /mcp URL

No secrets required; tweak cities/units in the Azure dashboard or via azd env set WEATHER_UNITS metric.

---