MCP with Playwright - Weather (Israel)

This project is the MCP (Model Context Protocol) assignment from Malka Baruch's course: "MCP with Playwright".

Project purpose

The MCP server provides weather forecasts for Israeli cities using Playwright to drive a real browser and scrape data from https://www.weather2day.co.il/forecast. The goal is to enable an LLM (Claude) to control a browser through exposed Tools so it can retrieve live web data without a traditional API.

What I implemented

Tools (MCP server - weather_Israel.py):

1. open_weather_forecast_israel()

   • Opens a Chromium browser (headless=False) and navigates to the forecast site. Keeps the browser and Page instances in a global context to persist between Tool calls.

2. enter_weather_search_israel(city: str)

   • Types the given city name into the site's search field and waits for the autocomplete list to appear.

3. select_weather_forecast_city_israel()

   • Selects the first autocomplete result (or presses Enter) and waits for the forecast page to load.

4. extract_weather_data_israel()

   • Extracts the visible forecast text from the loaded page and performs cleaning to remove advertisements and UI noise so the LLM receives only useful weather data.

How to run

1. From the project-template folder:

cd C:\Users\user1\Downloads\dovrot-ai-projects-master\dovrot-ai-projects-master\8-mcp\project-template
uv sync
uv run playwright install chromium

2. Start the host (terminal chat interface):

uv run host.py

3. In the host chat prompt, ask a question such as:

• "מה התחזית בתל אביב היום?"
• "תן חיזוי גשם בתל אביב מחר"

The host should route the request to the weather-Israel MCP and the LLM will call the Tools in sequence (open → enter → select → extract) to fetch and return the forecast.

Submission instructions

• Push the repository to GitHub as a public repo.
• Include this README.md describing purpose and run instructions.
• Make sure .env is not committed with real API keys. Use .env.example with placeholders.

Notes and troubleshooting

• Ensure ANTHROPIC_API_KEY is set in your environment if running with the Anthropic SDK (Claude).
• If Playwright selectors break (site changed), update the selectors in weather_Israel.py according to the site's HTML (inspect with DevTools).

---

This README follows the course submission guidelines: purpose, run steps, and example queries.