met-mcp

Un servidor MCP para pronósticos meteorológicos de MET Norway (Yr). Construido como proyecto de aprendizaje.

Disponible de tres maneras:

• npm: met-mcp — ejecutar localmente sobre stdio

• Remoto: https://met-mcp.met-mcp-worker.workers.dev/mcp — HTTP transmisible en Cloudflare Workers, agrégalo como conector de claude.ai

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

Herramientas

• geocode_location(name, count) — encuentra coordenadas para un nombre de lugar. Utiliza el geocodificador gratuito de Open-Meteo, porque MET no tiene API de geocodificación.

• get_forecast(latitude, longitude, hours) — pronóstico por horas de MET Locationforecast 2.0. Funciona en todo el mundo, mejor en los países nórdicos.

• get_nowcast(latitude, longitude) — precipitación basada en radar para las próximas 2 horas. Solo países nórdicos.

• get_weather_alerts(latitude?, longitude?) — avisos oficiales de peligro noruegos (MetAlerts). Omite las coordenadas para toda Noruega.

• get_sun_events(latitude, longitude, date, utc_offset) — amanecer, atardecer y mediodía solar. En todo el mundo.

• get_ocean_forecast(latitude, longitude, hours) — altura de ola y temperatura del mar a lo largo de la costa noruega.

• find_weather_stations(latitude, longitude, count) — estaciones meteorológicas oficiales más cercanas (Frost).

• get_historical_weather(station_id, from, to, elements) — observaciones históricas diarias del archivo Frost; algunas estaciones se remontan a más de 100 años.

Las dos herramientas de Frost necesitan un ID de cliente gratuito de https://frost.met.no/auth/requestCredentials.html, configurado como variable de entorno FROST_CLIENT_ID (o un secreto de Cloudflare para el worker). Las demás herramientas no necesitan nada.

Las definiciones de herramientas están en src/tools.ts, compartidas entre el servidor stdio y el worker.

Related MCP server: OpenWeatherMap MCP Server

Compilar y probar

npm install
npm run build
npm test

La prueba inicia el servidor sobre stdio y llama a ambas herramientas contra las APIs en vivo.

Uso con Claude Code

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

Luego pregunta a Claude: "¿Qué tiempo hará mañana en Bergen?"

Términos de servicio de MET

• Envía un User-Agent identificativo con información de contacto. Configura la variable de entorno MET_USER_AGENT, p. ej. met-mcp/0.1.0 you@example.com.

• Envía como máximo 4 decimales en las coordenadas. El servidor redondea por ti.

• Licencia de datos: NLOD / CC BY 4.0. Da crédito a MET Norway cuando muestres los datos.

Versión remota

worker/ contiene el despliegue de Cloudflare Workers: las mismas dos herramientas servidas sobre MCP Streamable HTTP con createMcpHandler (MCP SDK v2). Desarrolla con npm run dev, publica con npm run deploy (ambos desde worker/).

Cómo funciona

• src/index.ts es todo el servidor. Habla MCP sobre stdio: JSON-RPC en stdin/stdout.

• Cada herramienta declara un esquema de entrada con Zod. El cliente MCP (Claude) lee el esquema y valida los argumentos.

• Los resultados de las herramientas son bloques content. Este servidor devuelve JSON como texto, recortado a lo que necesita un LLM: la respuesta cruda de MET tiene ~90 pasos de tiempo con muchos más campos.

• Nunca escribas a stdout con console.log. Corrompe el flujo del protocolo. Registra en stderr.