MCP с Playwright — Погода (Израиль)

Этот проект является заданием по MCP (Model Context Protocol) из курса Малки Баруха: «MCP с Playwright».

Цель проекта

MCP-сервер предоставляет прогнозы погоды для израильских городов, используя Playwright для управления реальным браузером и извлечения данных с сайта https://www.weather2day.co.il/forecast. Цель — дать возможность LLM (Claude) управлять браузером через предоставленные инструменты, чтобы получать актуальные веб-данные без традиционного API.

Related MCP server: MCP Playwright Weather Israel

Что я реализовал

Инструменты (MCP-сервер — weather_Israel.py):

1. open_weather_forecast_israel()

   • Открывает браузер Chromium (headless=False) и переходит на сайт прогноза погоды. Сохраняет экземпляры браузера и страницы в глобальном контексте для сохранения состояния между вызовами инструментов.

2. enter_weather_search_israel(city: str)

   • Вводит название города в поле поиска на сайте и ожидает появления списка автодополнения.

3. select_weather_forecast_city_israel()

   • Выбирает первый результат автодополнения (или нажимает Enter) и ожидает загрузки страницы прогноза.

4. extract_weather_data_israel()

   • Извлекает видимый текст прогноза с загруженной страницы и выполняет очистку от рекламы и элементов интерфейса, чтобы LLM получала только полезные данные о погоде.

Как запустить

1. Из папки project-template:

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. Запустите хост (терминальный интерфейс чата):

uv run host.py

3. В чате хоста задайте вопрос, например:

• «מה התחזית בתל אביב היום?»

• «תן חיזוי גשם בתל אביב מחר»

Хост должен направить запрос к MCP weather-Israel, и LLM вызовет инструменты последовательно (открыть → ввести → выбрать → извлечь), чтобы получить и вернуть прогноз.

Инструкции по сдаче

• Загрузите репозиторий на GitHub как публичный репозиторий.

• Включите этот README.md с описанием цели и инструкциями по запуску.

• Убедитесь, что .env не загружается с реальными ключами API. Используйте .env.example с заполнителями.

Примечания и устранение неполадок

• Убедитесь, что ANTHROPIC_API_KEY установлен в вашем окружении, если вы запускаете с Anthropic SDK (Claude).

• Если селекторы Playwright перестали работать (сайт изменился), обновите селекторы в weather_Israel.py в соответствии с HTML сайта (проверьте через DevTools).

Этот README соответствует требованиям курса: цель, шаги запуска и примеры запросов.