# 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:

```powershell
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):

```powershell
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.