Repository navigation
Releases
v0.2.1 — Fix de packaging (resolución CJS)
aemet-mcp v0.2.1 🌦️
Corrección de packaging sobre la v0.2.0. Sin cambios funcionales.
🔧 Corregido
-
Resolución en CommonJS:
exportsdeclaraba solo la condiciónimport, así que
un consumidor que resolviera en CJS (ts-node,jesten modo CJS, otsxen un
proyecto sin"type": "module") fallaba al hacerrequire()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 sutype. La resolución ESM (import) ya funcionaba.
Nota: el bundle es ESM (
type: module). En Node ≥ 22.12require()de ESM
funciona de forma nativa, así que eldefaultresuelve y carga sin problema. En
Node anteriores, un consumidor puramente CJS necesitaría un build CJS aparte (no
incluido); la vía recomendada sigue siendoimport.
📦 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
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)yclaveAviso(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
fetchglobal se resuelve por llamada (compatible con runtimes que lo parchean, como Next.js).
v0.1.2 — Racha de viento + provenance
aemet-mcp v0.1.2 🌦️
Mejora incremental sobre la v0.1.1.
✨ Novedades
-
Racha máxima de viento en la predicción diaria:
prediccion_diariamuestra
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
aemet-mcp v0.1.1 🌦️
Versión de mejora incremental sobre la v0.1.0.
✨ Novedades
-
Humedad relativa en la predicción diaria:
prediccion_diariaahora 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:
sinNPM_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
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;fetchnativo,zlibnativo,
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/429a errores claros, reintentos con
backoff ante429y fallos de red/5xxtransitorios, 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
- Node.js ≥ 18
- API key gratuita de AEMET OpenData
(https://opendata.aemet.es/centrodedescargas/inicio → "Solicitar API Key").
📚 Documentación
- README — instalación y uso.
- Documentación funcional — capacidades y casos de uso.
- Arquitectura técnica — módulos, flujos y diagramas.
- Referencia de herramientas — entradas, salidas y errores.
- Decisiones de arquitectura (ADR).
Créditos: datos meteorológicos © AEMET; dataset de
municipios del INE. Software bajo licencia MIT.