MCP-Wetterserver

Ein Model Context Protocol (MCP)-Server, der mithilfe der AccuWeather-API stündliche und tägliche Wettervorhersagen bereitstellt.

Schnellstart

Sie benötigen einen AccuWeather-API-Schlüssel (kostenlose Stufe verfügbar).
Melden Sie sich hier an und erstellen Sie eine App, um Ihren Schlüssel zu erhalten.

Exportieren Sie Ihren API-Schlüssel als Umgebungsvariable:

Führen Sie dann den MCP-Wetterserver direkt mit folgendem Befehl aus:

Oder für HTTP/REST-Zugriff über Supergateway :

Beispiel für eine MCP-Serverkonfiguration

Zur Integration mit Claude Desktop oder anderen MCP-kompatiblen Clients fügen Sie dies zu Ihrer Konfiguration hinzu (z. B. claude_desktop_config.json ):

Überblick

Dieser MCP-Server ermöglicht großen Sprachmodellen (wie Claude) den Zugriff auf Echtzeit-Wetterdaten. Durch die Integration mit einem LLM ermöglicht er dem Modell:

• Holen Sie sich genaue und aktuelle Wettervorhersagen

• Bereitstellung stündlicher Wetterdaten für die nächsten 12 Stunden

• Zugriff auf tägliche Wettervorhersagen für bis zu 15 Tage

• Anzeige der Daten sowohl in metrischen (°C) als auch in imperialen (°F) Einheiten

• Temperatur, Bedingungen, Niederschlagsinformationen und andere Wetterdetails anzeigen

Voraussetzungen

• Node.js ≥18

• Ein AccuWeather-API-Schlüssel (festgelegt über .env oder Ihre Shell)

Aufstellen

1. Klonen Sie dieses Repository:

   git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather

2. Installieren Sie Abhängigkeiten:

   npm install

3. Holen Sie sich einen AccuWeather-API-Schlüssel:

   • Registrieren Sie sich bei AccuWeather API

   • Erstellen Sie eine neue App und erhalten Sie einen API-Schlüssel

4. Erstellen Sie eine

   ACCUWEATHER_API_KEY=your_api_key_here

5. Erstellen Sie das Projekt:

   npm run build

Verwendung mit Claude Desktop

1. Konfigurieren Sie Claude Desktop für die Verwendung dieses MCP-Servers:

   • Öffnen Sie Claude Desktop

   • Gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten

   • Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

   { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }

2. Starten Sie Claude Desktop neu

3. Aktivieren Sie in einer neuen Konversation den MCP-Server, indem Sie auf das Steckersymbol klicken und „Wetter“ auswählen.

4. Jetzt können Sie Claude nach Wettervorhersagen fragen, wie zum Beispiel:

   • „Wie ist die stündliche Wettervorhersage für New York City?“

   • „Geben Sie mir die 5-Tage-Vorhersage für London.“

   • „Wie wird das Wetter in Tokio diese Woche in Fahrenheit sein?“

   • „Wird es morgen in San Francisco regnen?“

Verfügbare Tools

Stündliche Wettervorhersage

• Toolname: weather-get_hourly

• Bietet stündliche Vorhersagen für die nächsten 12 Stunden

• Parameter:

  • sessionId (erforderlich): Eindeutige Kennung für die Sitzung

  • location (erforderlich): Stadt- oder Ortsname

  • units (optional): „metrisch“ (Celsius, Standard) oder „imperial“ (Fahrenheit)

Tägliche Wettervorhersage

• Toolname: weather-get_daily

• Bietet tägliche Vorhersagen für bis zu 15 Tage

• Parameter:

  • sessionId (erforderlich): Eindeutige Kennung für die Sitzung

  • location (erforderlich): Stadt- oder Ortsname

  • days (optional): Anzahl der Vorhersagetage (1, 5, 10 oder 15; Standard ist 5)

  • units (optional): „metrisch“ (Celsius, Standard) oder „imperial“ (Fahrenheit)

Entwicklung

• Installieren Sie Entwicklungsabhängigkeiten: npm install

• Lintisieren Sie Ihren Code: npm run lint

• Erstellen: npm run build

• Tests ausführen: npm test

• Im Dev-Modus starten: npm run dev

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Zukünftige Verbesserungen

Wir arbeiten ständig daran, den MCP-Wetterserver zu verbessern. Hier sind einige Funktionen, die wir für zukünftige Versionen in Betracht ziehen:

• Erweiterte stündliche Vorhersagen: Über 12 Stunden hinaus, z. B. 24 oder 48 Stunden.

• Wetterwarnungen: Integration mit der API für Unwetterwarnungen von AccuWeather.

• Standort-Autovervollständigung: Verbesserte Standortsuche mit Autovervollständigungsvorschlägen.

• Historische Wetterdaten: Zugriff auf vergangene Wetterbedingungen.

Wenn Sie Ideen für andere Funktionen haben, können Sie gerne ein Problem melden!

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .