Israel Weather MCP Server

🌤️ Israel Weather MCP Server

Ein benutzerdefinierter Model Context Protocol (MCP)-Server, der LLMs in die Lage versetzt, Echtzeit-Wettervorhersagen mit hoher Genauigkeit für israelische Städte abzurufen.

Anstatt auf generische globale APIs zurückzugreifen, nutzt dieser Agent Playwright, um eigenständig das lokale israelische Wetterportal (weather2day.co.il) zu öffnen, mit dem DOM zu interagieren und Live-Daten (RAG) direkt in den Chat-Kontext zu extrahieren.

🎯 Projektzweck

Dieses Projekt untersucht die Integration autonomer Browsersteuerung in eine KI-Agenten-Architektur. Die wichtigsten Lernziele sind:

1. Entwicklung eines benutzerdefinierten MCP-Servers: Aufbau eines dedizierten Servers, um einer LLM spezifische Tools bereitzustellen.

2. Browser-Automatisierung durch KI: Einsatz von Microsofts Playwright, um der LLM „Hände“ und „Augen“ im Web zu geben – damit sie navigieren, suchen, aus Autovervollständigungs-Dropdowns auswählen und Daten dynamisch scrapen kann.

3. Überwindung von Sprach- und Zustandsbarrieren: Umgang mit zustandsbehafteten Web-Interaktionen (Warten auf Animationen, sequenzielles Tippen) und Sicherstellung, dass die LLM Abfragen vor der Interaktion mit lokalen UI-Elementen korrekt ins Hebräische übersetzt.

🛠️ Technologie-Stack

• MCP SDK: Die offizielle Anthropic-Bibliothek zum Definieren des Protokolls und Bereitstellen von Tools.

• Playwright: Modernes Browser-Automatisierungstool zur programmgesteuerten Steuerung von Chromium.

• uv: Ultraschneller Python-Paket- und Umgebungsmanager.

🚀 So führst du es aus

1. Voraussetzungen

Stelle sicher, dass uv auf deinem System installiert ist.

• 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. Umgebung einrichten

Klongiere das Repository, navigiere in den Ordner project-template und synchronisiere die Abhängigkeiten:

uv sync

3. Browser-Engine installieren

Installiere den Chromium-Browser, der von Playwright benötigt wird:

uv run playwright install chromium

4. Host starten

Starte den interaktiven Terminal-Chat, um mit dem Agenten zu kommunizieren:

uv run host.py

💬 Beispielabfragen

Sobald der Host läuft, kannst du den Agenten zum Beispiel Folgendes fragen:

• „Wie ist die Wettervorhersage in Jerusalem?“

• „מה מזג האוויר בתל אביב היום?“

• „Wird es morgen in Haifa regnen?“

Beobachte, wie die Magie geschieht: Der Agent öffnet automatisch Chromium, übersetzt den Stadtnamen ins Hebräische, sucht danach, wählt die richtige Autovervollständigungsoption aus, extrahiert die neueste Vorhersage und liefert dir direkt im Terminal eine saubere, lokalisierte Antwort!

Entwickelt von SARA DEI