Skip to content

Releases

v0.2.1 — Fix de packaging (resolución CJS)

Choose a tag to compare

@rldona rldona released this 19 Jul 16:46

aemet-mcp v0.2.1 🌦️

Corrección de packaging sobre la v0.2.0. Sin cambios funcionales.

🔧 Corregido

  • Resolución en CommonJS: exports declaraba solo la condición import, así que
    un consumidor que resolviera en CJS (ts-node, jest en modo CJS, o tsx en un
    proyecto sin "type": "module") fallaba al hacer require() con:

    Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined ...
    

    Se añade una condición default (catch-all) apuntando al mismo bundle ESM, de
    modo que cualquier runner resuelve el paquete sin que el consumidor tenga que
    tocar su type. La resolución ESM (import) ya funcionaba.

"exports": {
  ".": {
    "types": "./dist/lib.d.ts",
    "import": "./dist/lib.js",
    "default": "./dist/lib.js"  // 👈 nuevo: fallback para resolución CJS
  }
}

Nota: el bundle es ESM (type: module). En Node ≥ 22.12 require() de ESM
funciona de forma nativa, así que el default resuelve y carga sin problema. En
Node anteriores, un consumidor puramente CJS necesitaría un build CJS aparte (no
incluido); la vía recomendada sigue siendo import.

📦 Instalación

{
  "mcpServers": {
    "aemet": {
      "command": "npx",
      "args": ["-y", "@rldona/aemet-mcp"],
      "env": { "AEMET_API_KEY": "TU_KEY" }
    }
  }
}

Créditos: datos meteorológicos © AEMET; municipios del
INE. Software bajo licencia MIT.

v0.2.0 — API de librería + fix de mojibake

Choose a tag to compare

@rldona rldona released this 19 Jul 14:08

Añadido

  • API de librería: import { AemetClient, buscarMunicipios, obtenerAvisos, … } from "@rldona/aemet-mcp" — el núcleo que resuelve la fontanería de AEMET OpenData (dos pasos, encoding, caché TTL, backoff, municipios INE, áreas CAP, avisos tar+XML) ahora es reutilizable desde cualquier backend Node/TS, además del servidor MCP (npx aemet-mcp).
  • areaParaMunicipio(codigoINE) y claveAviso(aviso).

Corregido

  • Mojibake en respuestas de AEMET ("Andújar" → "Andújar"): el servidor de datos devuelve codificaciones distintas según el nodo (UTF-8, doble codificación…) declarando siempre ISO-8859-15. Decodificación con auto-detección + reparación cadena a cadena tras el parse. Descubierto en producción en notemojes.com.
  • El fetch global se resuelve por llamada (compatible con runtimes que lo parchean, como Next.js).

v0.1.2 — Racha de viento + provenance

Choose a tag to compare

@rldona rldona released this 19 Jul 13:15

aemet-mcp v0.1.2 🌦️

Mejora incremental sobre la v0.1.1.

✨ Novedades

  • Racha máxima de viento en la predicción diaria: prediccion_diaria muestra
    ahora la racha (km/h) junto al viento, cuando AEMET la proporciona.

    domingo 19/07
      Máx 36 °C / Mín 22 °C  |  Cielo: Poco nuboso  |  Prob. precip.: 0%  |  Viento: SO 15 km/h (racha 30 km/h)  |  Humedad: 70 % / 20 %
    

🔧 Interno

  • Primera versión publicada con provenance mediante Trusted Publishing (OIDC).
    La v0.1.1 se publicó por OIDC pero sin atestación (faltaba el flag
    --provenance, ya corregido).

📦 Instalación

{
  "mcpServers": {
    "aemet": {
      "command": "npx",
      "args": ["-y", "@rldona/aemet-mcp"],
      "env": { "AEMET_API_KEY": "TU_KEY" }
    }
  }
}

Créditos: datos meteorológicos © AEMET; municipios del
INE. Software bajo licencia MIT.

v0.1.1 — Humedad en predicción diaria + OIDC

Choose a tag to compare

@rldona rldona released this 19 Jul 12:49

aemet-mcp v0.1.1 🌦️

Versión de mejora incremental sobre la v0.1.0.

✨ Novedades

  • Humedad relativa en la predicción diaria: prediccion_diaria ahora muestra
    la humedad máxima y mínima de cada día (AEMET ya la proporcionaba y no se
    mostraba).

    domingo 19/07
      Máx 36 °C / Mín 22 °C  |  Cielo: Poco nuboso  |  Prob. precip.: 0%  |  Viento: SO 15 km/h  |  Humedad: 70 % / 20 %
    

🔧 Interno

  • Primera publicación mediante Trusted Publishing (OIDC) desde GitHub Actions:
    sin NPM_TOKEN, con provenance automática y publicación directa (sin staging).
    Ver ADR-0011 y la
    guía de publicación.

📦 Instalación

{
  "mcpServers": {
    "aemet": {
      "command": "npx",
      "args": ["-y", "@rldona/aemet-mcp"],
      "env": { "AEMET_API_KEY": "TU_KEY" }
    }
  }
}

Créditos: datos meteorológicos © AEMET; municipios del
INE. Software bajo licencia MIT.

v0.1.0 — Primera versión pública

Choose a tag to compare

@rldona rldona released this 19 Jul 09:00

aemet-mcp v0.1.0 🌦️

Primera versión pública de aemet-mcp, un servidor MCP
que da a Claude Desktop, Cursor y cualquier cliente MCP acceso al tiempo oficial
de España
a través de la API pública OpenData de AEMET.

Se instala y arranca con un solo npx, sin backend propio.

{
  "mcpServers": {
    "aemet": {
      "command": "npx",
      "args": ["-y", "@rldona/aemet-mcp"],
      "env": { "AEMET_API_KEY": "TU_KEY" }
    }
  }
}

✨ Qué incluye

5 herramientas MCP tipadas (esquemas zod, salida en texto legible):

Herramienta Para qué sirve
buscar_municipio Resuelve el nombre de un municipio a su código INE (tolerante a acentos).
prediccion_diaria Predicción de 1-7 días: máx/mín, cielo, prob. de lluvia y viento.
prediccion_horaria Predicción hora a hora de hoy y mañana.
observacion_estacion Última observación real de una estación meteorológica.
avisos Avisos meteorológicos vigentes por comunidad autónoma.

🧱 Ingeniería destacable

  • Encapsula las tres rarezas de la API de AEMET: el patrón de dos pasos
    (primero un sobre JSON, luego la descarga real), el encoding ISO-8859-1
    (latin1) y los avisos como tar.gz de XML (CAP) — todo resuelto sin
    dependencias pesadas (solo el SDK de MCP y zod; fetch nativo, zlib nativo,
    y parsers de tar/CAP propios).
  • 8132 municipios del padrón oficial del INE bundleados: resolver
    nombre → código sin llamadas extra.
  • Robustez: mapeo de estados 401/404/429 a errores claros, reintentos con
    backoff ante 429 y fallos de red/5xx transitorios, y caché en memoria con TTL.
  • Honestidad de datos: nada de mocks en producción. Si AEMET falla, el error
    se propaga tal cual, sin ocultarlo tras valores por defecto.

✅ Verificado contra la API real

Las 5 herramientas se probaron end-to-end por el protocolo MCP contra la API de
AEMET (predicción de Madrid, observación de Retiro, avisos de calor de Andalucía,
etc.). La suite incluye tests de integración reales (guardados por AEMET_API_KEY)
además de 36 unitarios con fetch mockeado.

🐛 Un bug real que la verificación cazó

El mapa de códigos de área de las comunidades autónomas para los avisos no sigue
el orden intuitivo
: van en orden alfabético y el código 65 es Canarias (no
Cantabria) y el 78 es Ceuta (no Canarias). Se detectó porque "Cantabria"
devolvía zonas de Gran Canaria, y se corrigió verificando código por código contra
la API. Hay test de regresión.

📋 Requisitos

📚 Documentación


Créditos: datos meteorológicos © AEMET; dataset de
municipios del INE. Software bajo licencia MIT.