🌤️ Израильский MCP-сервер погоды

Пользовательский сервер Model Context Protocol (MCP), который позволяет LLM получать в реальном времени высокоточные локализованные прогнозы погоды для израильских городов.

Вместо того чтобы полагаться на общие глобальные API, этот агент использует Playwright для автономной навигации по местному израильскому погодному порталу (weather2day.co.il), взаимодействия с DOM и извлечения живых данных (RAG) непосредственно в контекст чата.

🎯 Цель проекта

Этот проект исследует интеграцию автономного управления браузером в архитектуру AI-агента. Основные достигнутые учебные цели:

1. Разработка пользовательского MCP-сервера: Создание выделенного сервера для предоставления конкретных инструментов LLM.

2. Автоматизация браузера через ИИ: Использование Playwright от Microsoft для предоставления LLM «рук» и «глаз» в вебе — позволяя ему навигировать, искать, выбирать из выпадающих списков автодополнения и динамически извлекать данные.

3. Преодоление языковых и государственных барьеров: Обработка государственных веб-взаимодействий (ожидание анимаций, последовательный ввод) и обеспечение правильного перевода запросов LLM на иврит перед взаимодействием с локальными элементами интерфейса.

🛠️ Технологический стек

• MCP SDK: Официальная библиотека Anthropic для определения протокола и предоставления инструментов.

• Playwright: Современный инструмент автоматизации браузера, используемый для программного управления Chromium.

• uv: Сверхбыстрый менеджер пакетов и окружений Python.

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

1. Предварительные требования

Убедитесь, что на вашей системе установлен uv.

• Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Mac/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

2. Настройка окружения

Клонируйте репозиторий, перейдите в папку project-template и синхронизируйте зависимости:

uv sync

3. Установка браузерного движка

Установите браузер Chromium, необходимый для Playwright:

uv run playwright install chromium

4. Запуск хоста

Запустите интерактивный терминальный чат, чтобы начать общение с агентом:

uv run host.py

💬 Примеры запросов

После запуска хоста вы можете задавать агенту вопросы, например:

• «Какой прогноз в Иерусалиме?»

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

• «Будет ли дождь в Хайфе завтра?»

Наблюдайте за магией: Агент автоматически откроет Chromium, переведет название города на иврит, найдет его, выберет правильный вариант автодополнения, извлечет последний прогноз и предоставит вам чистый, локализованный ответ прямо в терминале!

Разработано SARA DEI