🌤️ — Israel Weather Forecast

A learning project in MCP (Model Context Protocol) development: an LLM-based agent that can fetch weather forecasts for cities in Israel and the US, and answer in free language in the terminal chat.

🎯 Project Goal

Build a dedicated MCP server that "teaches" the LLM to perform a task it can't do on its own — fetch a weather forecast from an Israeli site that has no API.

The agent does this in two ways:

1. Israel server (weather-Israel) — automates a real browser with Playwright: opens weather2day.co.il/forecast, searches for a city, selects it, and then extracts the forecast page content and feeds it to the LLM to answer on its own (RAG approach).

2. US server (weather-USA) — fetches forecast and alerts via the official NWS (National Weather Service) API.

The Host connects all servers to the LLM (Gemini, via the OpenAI-compatible API), automatically collects all the Tools from them, and runs a chat loop where the LLM chooses which tool to use and activates them one by one until an answer is received.

Related MCP server: mcp-playwright-weather-israel

🏗️ Project Structure

project-template/
├── host.py            # צ'אט בטרמינל שמחבר את ה-LLM לכל שרתי ה-MCP
├── client.py          # MCP Client גנרי (מתחבר לשרת, מריץ Tools)
├── weather_USA.py     # שרת MCP לארה"ב — דרך NWS API
├── weather_Israel.py  # שרת MCP לישראל — דרך אטמוט דפדפן (Playwright)
├── pyproject.toml     # תלויות הפרויקט
└── README.md

Israel Server Tools

💡 The first three share the same browser via a global state (_page), because they all run in the same server process. The fourth iterates over all frames in the page, because the forecast itself loads inside an <iframe> that the main body doesn't see.

⚙️ Installation and Running

Prerequisites

• Python ≥ 3.13

• uv (environment and dependency manager)

• Gemini API key (get a free key)

Steps

# 1. התקנת התלויות והקמת סביבת העבודה
uv sync

# 2. התקנת דפדפן Chromium עבור Playwright
uv run playwright install chromium

Setting Environment Variables

Create a .env file in the project directory:

GEMINI_API_KEY=your_api_key_here
GEMINI_MODEL=gemini-2.0-flash

Running

uv run host.py

After launching, a Query: prompt will appear — type a question (or quit to exit).

💬 Example Questions the Agent Can Answer

Israel Forecast (Playwright)

A browser window opens showing the forecast page, and the LLM also answers in the chat.

• "What's the forecast in Tel Aviv?"

• "How many degrees are expected tomorrow in Jerusalem?"

• "How's the weather in Haifa today?"

• "Open the forecast for Be'er Sheva for me"

US Forecast and Alerts (NWS API)

• "What's the weather forecast for San Francisco?" (latitude/longitude)

• "Are there any weather alerts in California?"

• "Show me active weather alerts for NY"

🧩 How It Works (Flowchart)

משתמש → "מה התחזית בתל אביב?"
   │
   ▼
 Host  ──►  LLM (Gemini) בוחר Tools להפעיל
   │
   ▼  (שרת ישראל, בזה אחר זה)
 open → enter("תל אביב") → select → get_content
   │
   ▼
 תוכן התחזית חוזר ל-LLM (RAG)
   │
   ▼
 LLM כותב תשובה בשפה חופשית בצ'אט ✨

📝 Notes

• The LLM is the one that decides which Tools to run and in what order — we didn't write hard-coded logic.

• Two server files = two separate processes, so any shared state (like the open browser) must live inside only one server.