MCP with Playwright - Weather (Israel)

Dieses Projekt ist die MCP (Model Context Protocol) Aufgabe aus Malka Baruchs Kurs: "MCP with Playwright".

Projektzweck

Der MCP-Server bietet Wettervorhersagen für israelische Städte, indem er Playwright verwendet, um einen echten Browser zu steuern und Daten von https://www.weather2day.co.il/forecast zu scrapen. Das Ziel ist es, einem LLM (Claude) zu ermöglichen, einen Browser über bereitgestellte Tools zu steuern, damit es Live-Webdaten ohne eine traditionelle API abrufen kann.

Related MCP server: MCP Playwright Weather Israel

Was ich implementiert habe

Tools (MCP-Server - weather_Israel.py):

1. open_weather_forecast_israel()

   • Öffnet einen Chromium-Browser (headless=False) und navigiert zur Vorhersageseite. Behält die Browser- und Page-Instanzen in einem globalen Kontext, um sie zwischen Tool-Aufrufen beizubehalten.

2. enter_weather_search_israel(city: str)

   • Gibt den angegebenen Stadtnamen in das Suchfeld der Seite ein und wartet, bis die Autovervollständigungsliste erscheint.

3. select_weather_forecast_city_israel()

   • Wählt das erste Autovervollständigungsergebnis aus (oder drückt Enter) und wartet, bis die Vorhersageseite geladen ist.

4. extract_weather_data_israel()

   • Extrahiert den sichtbaren Vorhersagetext von der geladenen Seite und führt eine Bereinigung durch, um Werbung und UI-Rauschen zu entfernen, sodass das LLM nur nützliche Wetterdaten erhält.

So wird es ausgeführt

1. Aus dem Ordner 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. Starten Sie den Host (Terminal-Chat-Interface):

uv run host.py

3. Geben Sie im Host-Chat-Prompt eine Frage ein, wie zum Beispiel:

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

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

Der Host sollte die Anfrage an das weather-Israel MCP weiterleiten und das LLM wird die Tools in der Reihenfolge aufrufen (open → enter → select → extract), um die Vorhersage abzurufen und zurückzugeben.

Einreichungshinweise

• Pushen Sie das Repository als öffentliches Repo auf GitHub.

• Fügen Sie diese README.md bei, die Zweck und Ausführungsanweisungen beschreibt.

• Stellen Sie sicher, dass .env nicht mit echten API-Schlüsseln committet wird. Verwenden Sie .env.example mit Platzhaltern.

Hinweise und Fehlerbehebung

• Stellen Sie sicher, dass ANTHROPIC_API_KEY in Ihrer Umgebung gesetzt ist, wenn Sie mit dem Anthropic SDK (Claude) ausführen.

• Falls Playwright-Selektoren nicht mehr funktionieren (Seite geändert), aktualisieren Sie die Selektoren in weather_Israel.py entsprechend dem HTML der Seite (mit DevTools inspizieren).

Diese README folgt den Einreichungsrichtlinien des Kurses: Zweck, Ausführungsschritte und Beispielabfragen.