met-mcp

Ein MCP-Server für Wettervorhersagen von MET Norwegen (Yr). Als Lernprojekt gebaut.

Verfügbar auf drei Arten:

• npm: met-mcp — lokal über stdio ausführen

• Remote: https://met-mcp.met-mcp-worker.workers.dev/mcp — Streamable HTTP auf Cloudflare Workers, als claude.ai-Connector hinzufügen

• MCP-Registry: io.github.trondbjoroy/met-mcp

Werkzeuge

• geocode_location(name, count) — Koordinaten für einen Ortsnamen finden. Verwendet den kostenlosen Open-Meteo-Geocoder, da MET keine Geocoding-API hat.

• get_forecast(latitude, longitude, hours) — stündliche Vorhersage von MET Locationforecast 2.0. Funktioniert weltweit, am besten in den nordischen Ländern.

• get_nowcast(latitude, longitude) — radarbasierter Niederschlag für die nächsten 2 Stunden. Nur in den nordischen Ländern.

• get_weather_alerts(latitude?, longitude?) — offizielle norwegische Gefahrenwarnungen (MetAlerts). Koordinaten weglassen für ganz Norwegen.

• get_sun_events(latitude, longitude, date, utc_offset) — Sonnenaufgang, Sonnenuntergang und Sonnenhöchststand. Weltweit.

• get_ocean_forecast(latitude, longitude, hours) — Wellenhöhe und Meerestemperatur entlang der norwegischen Küste.

• find_weather_stations(latitude, longitude, count) — nächstgelegene offizielle Wetterstationen (Frost).

• get_historical_weather(station_id, from, to, elements) — tägliche historische Beobachtungen aus dem Frost-Archiv; einige Stationen reichen über 100 Jahre zurück.

Die beiden Frost-Werkzeuge benötigen eine kostenlose Client-ID von https://frost.met.no/auth/requestCredentials.html, die als Umgebungsvariable FROST_CLIENT_ID gesetzt wird (oder als Cloudflare-Secret für den Worker). Die anderen Werkzeuge benötigen nichts.

Die Werkzeugdefinitionen befinden sich in src/tools.ts, gemeinsam genutzt zwischen dem stdio-Server und dem Worker.

Related MCP server: OpenWeatherMap MCP Server

Build und Test

npm install
npm run build
npm test

Der Test startet den Server über stdio und ruft beide Werkzeuge gegen die Live-APIs auf.

Verwendung mit Claude Code

claude mcp add met-weather -- node C:\Users\trond\met-mcp\dist\index.js

Frage dann Claude: „Wie ist das Wetter morgen in Bergen?"

MET-Nutzungsbedingungen

• Sende einen identifizierenden User-Agent mit Kontaktinformationen. Setze die Umgebungsvariable MET_USER_AGENT, z. B. met-mcp/0.1.0 you@example.com.

• Sende höchstens 4 Dezimalstellen in Koordinaten. Der Server rundet für dich.

• Datenlizenz: NLOD / CC BY 4.0. Nenne MET Norwegen, wenn du die Daten zeigst.

Remote-Version

worker/ enthält die Cloudflare-Workers-Bereitstellung: dieselben zwei Werkzeuge, bereitgestellt über MCP Streamable HTTP mit createMcpHandler (MCP SDK v2). Entwickle mit npm run dev, veröffentliche mit npm run deploy (beide aus worker/).

So funktioniert es

• src/index.ts ist der gesamte Server. Er spricht MCP über stdio: JSON-RPC auf stdin/stdout.

• Jedes Werkzeug deklariert ein Eingabeschema mit Zod. Der MCP-Client (Claude) liest das Schema und validiert Argumente.

• Werkzeugergebnisse sind content-Blöcke. Dieser Server gibt JSON als Text zurück, zugeschnitten auf das, was ein LLM benötigt — die rohe MET-Antwort hat ~90 Zeitschritte mit weit mehr Feldern.

• Schreibe niemals mit console.log auf stdout. Das beschädigt den Protokollstrom. Logge auf stderr.