F
licenseNot graded
qualityD
maintenanceEnables querying real-time weather data for Israeli cities through natural language, using Playwright to scrape weather2day and Gemini LLM to answer.
-
Weather Israel MCP Server
Integrates with Google's Gemini API to analyze user queries and formulate responses for weather forecasts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Weather Israel MCP Serverwhat's the weather in Tel Aviv?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π€οΈ Weather Israel β Agentic MCP Server with Browser Automation
An AI-powered weather assistant that autonomously controls a browser to fetch real-time Israeli weather forecasts using the Model Context Protocol (MCP) and Playwright.
π Overview
This project implements a custom MCP (Model Context Protocol) Server that gives an LLM autonomous browser control capabilities. Instead of relying on a traditional weather API, the system opens a real browser, navigates to an Israeli weather website, searches for a city, and extracts the live forecast β just like a human would.
The LLM (Gemini 2.5 Flash) acts as the orchestrating agent, deciding which tools to invoke and in what sequence, creating a fully autonomous agentic pipeline.
Why is this interesting?
No API needed β scrapes data directly from the web using browser automation
Agentic architecture β the LLM decides which tools to call and when
MCP standard β uses Anthropic's open protocol for tool communication
RAG pattern β extracts page content and feeds it back to the LLM for reasoning
Related MCP server: MCP Playwright Weather Israel
π― Project Goals
Implement a custom MCP Server from scratch
Use Playwright to add browser automation capabilities to an LLM
Demonstrate agentic tool-calling with multi-step orchestration
Build a complete RAG pipeline β retrieve data β augment context β generate response
ποΈ Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β User Query β
β "What's the weather in Tel Aviv?" β
βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β host.py (Orchestrator) β
β Gemini 2.5 Flash + Tool Calling β
βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββ
β MCP Protocol
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β weather_Israel.py (MCP Server) β
β β
β Tool 1: open_weather_forecast_israel() β
β Tool 2: enter_weather_forecast_city_israel(city) β
β Tool 3: select_weather_forecast_city_israel() β
β Tool 4: get_weather_page_content() β
βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββ
β Playwright
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β weather2day.co.il (Live Website) β
β Real-time weather data scraped from browser β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββπ οΈ Tech Stack
Technology | Purpose |
Python 3.13+ | Core language |
MCP SDK | Model Context Protocol β exposes tools to the LLM |
Playwright | Headless browser automation (Chromium) |
Gemini 2.5 Flash | LLM for reasoning and tool orchestration |
httpx | HTTP client for Gemini REST API calls |
uv | Modern Python package manager |
π Project Structure
MCP/
βββ weather_Israel.py # MCP Server β Israeli weather tools (Playwright)
βββ weather_USA.py # MCP Server β US weather tools (API-based)
βββ host.py # Orchestrator β Gemini + MCP client integration
βββ client.py # Generic MCP client connector
βββ pyproject.toml # Dependencies and project metadata
βββ .env.example # Environment variable template
βββ .gitignore # Git ignore rules
βββ uv.lock # Locked dependencies
βββ README.md # This fileπ§ MCP Tools β weather_Israel.py
# | Tool | Description |
1 |
| Launches Chromium and navigates to the weather website |
2 |
| Types the city name into the search field using keyboard simulation |
3 |
| Clicks the first autocomplete result from the dropdown |
4 |
| Extracts and cleans the visible text from the forecast page |
β‘ Prerequisites
Python 3.13 or higher
uv package manager (
pip install uv)Gemini API Key from Google AI Studio
π¦ Installation
1. Clone the repository
git clone https://github.com/yael3222664-alt/MCP.git
cd MCP2. Install dependencies
uv sync3. Install Chromium for Playwright
uv run playwright install chromium4. Configure environment variables
Create a .env file in the project root:
GEMINI_API_KEY=your_gemini_api_key_hereGet your free API key at Google AI Studio
π Running the Application
python -m uv run host.pyYou'll see:
MCP Client Started!
Type your queries or 'quit' to exit.
Query: π¬ Example Queries & Output
Query:
ΧΧ ΧΧΧ ΧΧΧΧΧΧ¨ ΧΧΧ Χ ΧΧ¨Χ§?Agent Actions:
[Calling tool weather_Israel__open_weather_forecast_israel with args {}]
[Calling tool weather_Israel__enter_weather_forecast_city_israel with args {'city': 'ΧΧ Χ ΧΧ¨Χ§'}]
[Calling tool weather_Israel__select_weather_forecast_city_israel with args {}]
[Calling tool weather_Israel__get_weather_page_content with args {}]Response:
The current temperature in Bnei Brak is 30Β°C with wind speed of 15 km/h
and gusts up to 37 km/h from the west. Humidity is at 52%.
Hourly forecast for today:
β’ 14:00 β 30Β°C, humidity 52%, wind 15 km/h
β’ 15:00 β 30Β°C, humidity 52%, wind 15 km/h
β’ 16:00 β 29Β°C, humidity 54%, wind 14 km/h
...More examples:
What's the weather in Jerusalem?
ΧΧ ΧΧͺΧΧΧΧͺ ΧΧΧΧ€Χ?
How's the weather in Tel Aviv today?
What are the weather alerts in California? (uses USA tools)οΏ½ How It Works β Step by Step
User asks a question β
"What's the weather in Tel Aviv?"Gemini analyzes the query and identifies the required tools
Tool 1 β Playwright opens a headless Chromium browser and navigates to the weather site
Tool 2 β Playwright types the city name into the search field (character by character to trigger autocomplete)
Tool 3 β Playwright clicks the first matching result in the dropdown
Tool 4 β Playwright extracts all visible text from the forecast page
Gemini receives the raw page content and formulates a clean, structured answer
User gets a natural language response with temperature, wind, humidity, and hourly forecast
π§ Key Design Decisions
Keyboard simulation (
keyboard.type()) instead offill()β triggers the website's JavaScript autocompleteDirect REST API calls to Gemini with
httpx(verify=False)β bypasses SSL issues in restricted network environmentsGlobal browser state β shared between tool calls so the same page instance persists across the multi-step workflow
Graceful error handling β each tool validates state and returns clear error messages
π Troubleshooting
Issue | Solution |
| Use |
| Create |
| Rate limit β wait 1 minute or use a different API key |
Browser doesn't open | Run |
SSL errors | The code already disables SSL verification for restricted networks |
π Resources
π License
This project is open source and available for educational purposes.
Built with Playwright π and the Model Context Protocol π€
Available Tools
4 toolsenter_weather_forecast_city_israelB
Enters a city name into the search input field on the weather forecast page.
Args: city: The name of the city to search for
Returns: A message indicating success or failure
Inputs: city (required). Returns: result
get_weather_page_contentA
Extracts the weather forecast data from the currently loaded page.
Returns: The weather forecast text content from the page, or an error message
Inputs: no named parameters. Returns: result
open_weather_forecast_israelA
Opens a Chromium browser and navigates to the Israeli weather forecast website.
Returns: A message indicating success or failure
Inputs: no named parameters. Returns: result
select_weather_forecast_city_israelC
Clicks/selects the first item in the dropdown list of cities.
Returns: A message indicating success or failure
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
TDQS
B3.4/5.0
Scored across 4 tools
Disambiguation5/5
Each tool performs a distinct step in the weather forecast workflow: opening the site, entering a city, selecting from a dropdown, and extracting the content. No two tools have overlapping purposes.
Naming Consistency3/5
Most tools follow a 'verb_weather_forecast_city_israel' pattern, but 'get_weather_page_content' deviates by omitting 'israel' and using 'page_content' instead of 'forecast', causing inconsistency.
Tool Count4/5
Four tools is a reasonable number for a focused weather query server, covering the essential steps without unnecessary complexity.
Completeness3/5
The tools cover the basic flow of opening the page, searching, selecting, and retrieving content, but lack support for error recovery, multiple cities, or closing the browser, leaving minor gaps.
Maintenance
ActivityInactive
ResponsivenessNo recent community issues
Related MCP Connectors
Get current weather for any city and create images from your prompts. Streamline planning, reportsβ¦
Current weather and forecast lookup as an agent tool.
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Global weather via Open-Meteo: forecast, historical, marine, air quality, geocoding, elevation.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables an LLM to retrieve Israeli weather forecasts by controlling a real Chromium browser to search and scrape a weather site.5-
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to retrieve Israeli weather forecasts by controlling a browser via Playwright and scraping data from an Israeli weather website.-
- FlicenseAqualityDmaintenanceEnables LLMs to fetch Israeli weather forecasts by controlling a real browser via Playwright, simulating human interactions like typing and clicking on a weather website.4-