io.github.jocarrd由 GitHub 账号 jocarrd 发布v0.3.3更新于 Oct 29, 2026
MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.
本地 MCP 服务器，让助手获取西班牙 AEMET 官方天气预报、预警、实况观测、气候历史以及海滩、山地、海洋和空气质量数据。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
A Model Context Protocol server that lets LLM clients — Claude Desktop, Cursor, Windsurf, Zed, custom agents — answer questions about Spain's weather using real data from AEMET, the State Meteorological Agency.
Versión en español · Servidor MCP con ocho herramientas sobre los datos abiertos de AEMET. Requiere Node.js 20.19 o superior.
Built on top of aemet-client,
the same TypeScript SDK that powers snowy.es.
Runs locally over stdio — no hosted infrastructure, no shared API key. Every user supplies their own free AEMET key.
Free, takes about a minute:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS
or %APPDATA%\Claude\claude_desktop_config.json on Windows and add:
Restart Claude Desktop and ask: "What's the weather forecast for Madrid this week?", "Are there any active weather warnings in Catalonia right now?", "How much did it rain in Logroño last August?" or "What's the water temperature at La Concha?".
Same config object — every MCP-capable client accepts the
{ command, args, env } shape. See their docs for where the config file lives.
get_forecastAEMET's official forecast for any of Spain's 8000+ municipalities.
get_warningsActive CAP (Common Alerting Protocol) warnings for an autonomous community or the whole country.
get_nearest_observationLatest real-time observation (temperature, humidity, wind, precipitation, pressure, visibility) from the AEMET station closest to a location.
get_climate_historyHistorical climate data from the AEMET station closest to a location: either daily records over a date range or the station's long-term monthly normals.
AEMET caps daily climate queries at 186 days per request, so longer ranges are rejected with a message explaining it. Ranges over a month come back aggregated by month (mean max/min, extremes, total precipitation, rain days) instead of one line per day.
get_beach_forecastThree-day forecast for any of the 591 beaches AEMET covers during the bathing season: sky, wind and waves split into morning and afternoon, plus maximum temperature, water temperature, thermal sensation and UV index.
Names resolve without accents and tolerate how people actually write them
("la kontxa", "playa de la concha, suances"). When a name matches more than
one beach, the server answers with the candidates and their codes. Outside the
bathing season AEMET stops publishing and the tool says so.
get_mountain_forecastAEMET's mountain bulletin for the nine areas it covers: the forecast by section, freezing-level altitudes, free-atmosphere winds, and temperatures at named refuges and passes with their altitude. Also serves the last 24 hours.
Common aliases work: "Guadarrama", "Moncayo", "Urbión", "Peñibética",
"Val d'Aran", "Gredos".
get_maritime_forecastAEMET's marine bulletins: coastal waters (8 areas) and high seas (3 areas), with warnings, the synoptic situation, the forecast per zone and the trend for the following day.
AEMET writes wind, sea state and visibility as a single text per zone, so the tool passes that text through rather than splitting it with guesswork.
get_air_qualityBackground pollution from AEMET's rural EMEP/VAG/CAMP reference network: regional background air, not urban air quality.
Measurements carry AEMET's validation codes, and values flagged as invalid are labelled so a model does not quote them as real readings.
AEMET rate-limits its API and some responses are heavy: the station inventory alone is 926 entries, and the server reads it on every climate query. Responses are therefore cached in memory for 10 minutes by default, per endpoint.
Set AEMET_CACHE_TTL in the same env block as the API key to change it, in
seconds, or to 0 to turn caching off:
The cache lives in the server process, so it disappears when your MCP client
closes it. Pass your own cache adapter through clientConfig if you need
something shared or persistent.
If you're building your own MCP integration, the server is also exposed as a library:
You can pass an existing AemetClient (for example one wired to a Redis cache)
instead of an API key:
location accepts free-form names because the package embeds the full INE
municipality dataset (8000+ entries) shipped by aemet-client. Searching for
"logrono", "Logroño" or "26089" all resolve to the same place. Decimal
coordinates resolve to the nearest municipality.
For autonomous communities, common aliases work: "Cataluña", "catalunya",
"Catalonia", "Euskadi", "País Vasco", "Comunitat Valenciana", etc.
MIT © Jorge Carrera
来源：packages/aemet-mcp/README.md，提交 279faac
Weather forecast for a Spanish municipality
Returns the AEMET forecast for any of Spain's 8000+ municipalities. Accepts a name (with or without accents) or INE code. Daily granularity returns temperature min/max, sky state, precipitation probability and wind for each day. Hourly returns the next ~40h.
dayslocation必填granularityActive CAP weather warnings for a Spanish region
Returns the most recent CAP (Common Alerting Protocol) weather warnings issued by AEMET for the given autonomous community, or for the whole country ('esp'). Severity follows the CAP standard: Minor, Moderate, Severe, Extreme.
area必填languageminSeverityLatest real-time observation from the nearest AEMET weather station
Finds the AEMET weather station closest to the requested location and returns its most recent reading (temperature, humidity, wind, precipitation, pressure). Useful for 'what's the weather right now' style questions.
location必填Historical climate records from the nearest AEMET climatological station
Finds the AEMET climatological station closest to the requested location and returns its measured history. mode='range' returns daily records (temperature, precipitation, wind, humidity, sunshine) between two dates; AEMET serves at most 6 months (186 days) per call, so longer histories need several calls. Ranges longer than 31 days are condensed into one line per month (mean max/min, total precipitation, rainy days, extremes) instead of one line per day. mode='normals' returns the station's long-term monthly averages. Use this for past weather and climate questions, not for forecasts.
tofrommodelocation必填Beach forecast for a Spanish beach
Returns the AEMET beach forecast for the next three days: sky, wind and waves for morning and afternoon, plus maximum temperature, water temperature, thermal sensation and maximum UV index. Covers the 591 beaches AEMET forecasts during the bathing season. Accepts a beach name (accents optional), optionally narrowed by municipality, or the 7-digit AEMET beach code.
dayslocation必填municipalityMountain bulletin for a Spanish mountain area
Returns the AEMET mountain bulletin for one of Spain's nine mountain areas (Picos de Europa, the three Pyrenean areas, the two Iberian System areas, Guadarrama and Somosierra, Sierra de Gredos, Sierra Nevada). Written for mountaineers and skiers: sky state, precipitation, storms, temperature and wind as forecaster prose, plus the freezing and -10 °C levels, free-atmosphere winds at 1500 and 3000 m, and minimum and maximum temperatures with thermal sensation at named refuges, passes and resorts. mode='forecast' covers today (day 0) to day 3; mode='past' summarises the last 24 hours. These bulletins are year-round and cover the mountain range as a whole, so use them instead of get_forecast for anything above the valley floor.
dayarea必填modeMaritime forecast for Spanish coastal waters and high seas
Returns the AEMET maritime bulletin for a sea area: sea state, wind, visibility, warnings and the validity period. Two products are covered: coastal waters (8 bulletins, one per stretch of the Spanish coast, each split into per-province zones and carrying the marine warnings) and high seas (3 bulletins covering the Atlantic north of 30N, the Atlantic south of 35N and the Mediterranean). Areas can be named the way people and the media name them, or given as AEMET codes.
area必填productBackground air pollution at an AEMET EMEP/VAG rural station
Returns the latest reading of AEMET's background pollution network (EMEP/VAG/CAMP): 13 rural reference stations that measure the regional baseline of O3, NO, NO2, SO2 and PM10, plus temperature, humidity, pressure, wind, radiation and precipitation. This is BACKGROUND pollution, measured far from towns and roads on purpose. It does NOT answer 'how is the air in Madrid/Barcelona today': urban air quality is measured by the city and regional networks, not by AEMET, and this tool must not be used as a proxy for it.
stationlocation已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
{ "mcpServers": { "aemet": { "command": "npx", "args": ["-y", "aemet-mcp"], "env": { "AEMET_API_KEY": "paste-your-key-here" } } }}"env": { "AEMET_API_KEY": "paste-your-key-here", "AEMET_CACHE_TTL": "1800"}import { createServer } from "aemet-mcp";import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const { server } = createServer({ apiKey: process.env.AEMET_API_KEY });await server.connect(new StdioServerTransport());import { AemetClient } from "aemet-client";import { createServer } from "aemet-mcp";
const client = new AemetClient({ apiKey, cache: { adapter: redisAdapter } });const { server } = createServer({ client });