Israel Weather Forecast MCP Server

Ein eigenständiger MCP-Server, der eine israelische Wettervorhersage durch die Ausführung eines echten Browsers (Playwright) abruft, nicht durch den Aufruf einer herkömmlichen API. Die Idee: Das Modell (der Host, z. B. Claude Desktop / Claude Code) ruft die Tools nacheinander auf, genau wie ein menschlicher Benutzer, der auf der Website navigiert: Es öffnet die Seite, tippt einen Stadtnamen ein, wählt sie aus der Autovervollständigungsliste aus und extrahiert schließlich den Seiteninhalt, um die Frage des Benutzers zu beantworten.

Projektstruktur

israel-weather-mcp/
├── server.py           # השרת עצמו - כל ה-tools מוגדרים כאן
├── requirements.txt
└── README.md

Related MCP server: Israel Weather MCP Agent

Implementierte Tools

Phase 1 – Navigation und Stadtsuche

Phase 2 – Inhaltsextraktion (RAG)

Der typische Ablauf (vom LLM erwartete Aufrufreihenfolge):

open_weather_forecast_israel
        ↓
enter_weather_forecast_city_israel("תל אביב")
        ↓
select_weather_forecast_city_israel("תל אביב")
        ↓
get_weather_forecast_content()   → הטקסט חוזר למודל, שמנסח תשובה למשתמש

Installation

cd israel-weather-mcp
python -m venv .venv
source .venv/bin/activate        # ב-Windows: .venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium      # מוריד את הדפדפן שה-Playwright מפעיל

Verbindung zum Host (z. B. Claude Desktop)

In der MCP-Konfigurationsdatei (z. B. claude_desktop_config.json) ist Folgendes hinzuzufügen:

{
  "mcpServers": {
    "israel-weather-forecast": {
      "command": "python",
      "args": ["/נתיב-מלא/israel-weather-mcp/server.py"]
    }
  }
}

Nach dem Speichern muss der Host neu gestartet werden. Die Tools erscheinen in der Liste der verfügbaren Tools, und man kann zum Beispiel fragen: "Wie ist die Vorhersage für Haifa heute?" – der Host führt die Tools nacheinander aus, um zu antworten.

Wichtiger Hinweis zu den Selektoren (Selectors)

Die exakte HTML-Struktur der Website ims.gov.il (die class-/id-Namen des Suchfelds, der Autovervollständigungselemente und des Vorhersagebereichs) kann sich mit Website-Updates ändern. Deshalb sind alle Selektoren im Wörterbuch SELECTORS am Anfang von server.py gebündelt, mit einigen Alternativen (Fallbacks) für jedes Element. Empfohlen wird:

1. Mit HEADLESS = False in der Datei server.py ausführen (Zeile neben den allgemeinen Einstellungen), um den Browser tatsächlich zu sehen.

2. Die Vorhersagewebsite in einem normalen Browser öffnen, mit einem Rechtsklick → „Untersuchen“ (Inspect) auf das Suchfeld / die Autovervollständigungsliste / den Vorhersagebereich klicken und die Listen im Wörterbuch SELECTORS entsprechend aktualisieren.

So lässt sich der Server auch anpassen, wenn man ihn auf eine andere israelische Wettervorhersage-Website umleiten möchte (z. B. die Website eines privaten Anbieters) statt auf ims.gov.il – man muss nur IMS_FORECAST_URL und SELECTORS aktualisieren.

Hochladen auf GitHub

Das Projekt ist bereits als lokales Git-Repository vorbereitet (es enthält einen ersten Commit). Um es auf GitHub hochzuladen und einen Link zum Senden an den Dozenten/Lehrer zu erhalten:

1. Gehen Sie zu github.com und klicken Sie auf New repository (ohne „Add README“ / „.gitignore“ / „license“ anzukreuzen – diese haben wir bereits).

2. Geben Sie einen Namen ein, z. B. israel-weather-mcp, und klicken Sie auf Create repository.

3. Führen Sie im Terminal im Projektordner (israel-weather-mcp/) Folgendes aus:

   git remote add origin https://github.com/<שם-המשתמש-שלכם>/israel-weather-mcp.git
   git branch -M main
   git push -u origin main

4. Nach dem Push ist der Link, den Sie an den Dozenten senden, die Repository-URL: https://github.com/<שם-המשתמש-שלכם>/israel-weather-mcp

Wenn Sie Git auf diesem Computer noch nicht zum ersten Mal eingerichtet haben, müssen Sie möglicherweise einmal Folgendes ausführen:

git config --global user.name "השם שלכם"
git config --global user.email "האימייל שלכם"

Direkte Ausführung zum Testen (ohne Host)

Man kann auch einen schnellen Test mit der MCP-CLI ausführen:

mcp dev server.py

Dies öffnet eine lokale Testoberfläche (MCP Inspector), in der die Tools direkt aufgerufen und die Ausgabe betrachtet werden können, ohne dass eine Verbindung zu Claude Desktop erforderlich ist.