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:
export ACCUWEATHER_API_KEY=your_api_key_here
Führen Sie dann den MCP-Wetterserver direkt mit folgendem Befehl aus:
npx -y @timlukahorstmann/mcp-weather
Oder für HTTP/REST-Zugriff über Supergateway :
npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
--port 4004 \
--baseUrl http://127.0.0.1:4004 \
--ssePath /messages \
--messagePath /message \
--cors "*" \
--env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"
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 ):
{
"mcpServers": {
"weather": {
"command": "npx",
"args": ["-y", "@timlukahorstmann/mcp-weather"],
"env": {
"ACCUWEATHER_API_KEY": "your_api_key_here"
}
}
}
}
Ü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
- Klonen Sie dieses Repository:
git clone https://github.com/TimLukaHorstmann/mcp-weather.git
cd mcp-weather
- Installieren Sie Abhängigkeiten:
- 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
- Erstellen Sie eine
.env Datei mit Ihrem API-Schlüssel:ACCUWEATHER_API_KEY=your_api_key_here
- Erstellen Sie das Projekt:
Verwendung mit Claude Desktop
- 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"
}
}
}
}
- Starten Sie Claude Desktop neu
- Aktivieren Sie in einer neuen Konversation den MCP-Server, indem Sie auf das Steckersymbol klicken und „Wetter“ auswählen.
- 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?“
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 Sitzunglocation (erforderlich): Stadt- oder Ortsnameunits (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 Sitzunglocation (erforderlich): Stadt- oder Ortsnamedays (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 .