io.github.jocarrd/aemet-mcp
MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
aemet-mcpclaude mcp add aemet-mcp -e 'AEMET_API_KEY=<your aemet_api_key>' -- npx -y aemet-mcp@0.3.3
{
"mcpServers": {
"aemet-mcp": {
"command": "npx",
"args": [
"-y",
"aemet-mcp@0.3.3"
],
"env": {
"AEMET_API_KEY": "<your aemet_api_key>"
}
}
}
}
متغيرات البيئة
AEMET_API_KEYإلزامي سري AEMET OpenData API key. Free at https://opendata.aemet.es/centrodedescargas/altaUsuario
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
aemet-client monorepo
Tools for working with AEMET OpenData, the public API of Spain's State Meteorological Agency.
| Package | Description | npm |
|---|---|---|
aemet-client | Typed TypeScript SDK + CLI for AEMET OpenData. Used in production at snowy.es. | |
aemet-mcp | Model Context Protocol server: plug AEMET into Claude Desktop, Cursor, Windsurf or any MCP client. Forecasts, warnings, live observations, climate history and beach forecasts. Runs locally over stdio. |
Quick links
- Just want to use AEMET from code? →
packages/aemet-client/README.md - Want your LLM to answer Spanish weather questions? →
packages/aemet-mcp/README.md - Spanish docs →
packages/aemet-client/README.es.md
Develop
Requires Node.js ≥ 20.18 and pnpm ≥ 10.
pnpm install
pnpm -r build
pnpm -r test
pnpm -r typecheck
pnpm lint
To work on a single package:
pnpm --filter aemet-client test
pnpm --filter aemet-mcp dev
The E2E suite (pnpm --filter aemet-client test:e2e) hits the real AEMET
API and is skipped unless AEMET_API_KEY is set. CI runs it behind a
repository secret.
Release
aemet-clientis released by pushing a tagv<x.y.z>oraemet-client-v<x.y.z>. The release workflow checks the tag matchespackages/aemet-client/package.jsonbefore publishing to npm via Trusted Publishing (OIDC, no token).aemet-mcpis released by pushing a tagaemet-mcp-v<x.y.z>using the same Trusted Publishing setup.pnpm publishrewrites theworkspace:^dependency onaemet-clientto a real semver range.
See CONTRIBUTING.md for development guidelines.
License
MIT © Jorge Carrera
الأسئلة الشائعة
ما هو io.github.jocarrd/aemet-mcp؟
MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.
كيف أثبّت io.github.jocarrd/aemet-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add aemet-mcp -e 'AEMET_API_KEY=<your aemet_api_key>' -- npx -y aemet-mcp@0.3.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.jocarrd/aemet-mcp إلى مفتاح API؟
نعم. يتطلب AEMET_API_KEY، وتضبطها في إعداداته.
هل io.github.jocarrd/aemet-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.jocarrd/aemet-mcp؟
ينشره jocarrd. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.