AEMET-MCP. Integration via MCP with the AEMET API

AEMET-MCP。通过 MCP 与 AEMET API 集成

描述

AEMET 是西班牙国家气象局。

Aemet-mcp 可让你直接通过 Claude AI 和其他兼容 MCP 的客户端，使用 Model Context Protocol（MCP） 从 AEMET API 获取历史气候数据和气象信息。

Aemet-mcp 是一个 MCP 服务，可提供工具，让 LLM 查询西班牙各地气象站的数据。

它包含安全的 API 密钥处理机制，以及用于提供辅助数据的资源 JSON 文件。

主要功能

• 查询历史每日数值（温度、风力、降水等）
• 按气象站获取月度气候摘要
• 按年份、月份和 AEMET 气象站代码筛选
• 查询海滩状况，包括紫外线指数
• 面向西班牙市镇的降雨数据分析提示词，使用历史降水数据
• 返回可直接使用的 JSON 格式响应

安装

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 AEMET Weather Data Server：

npx -y @smithery/cli install @AnCode666/aemet-mcp --client claude

使用 uv 安装

前置条件

• Python 3.10 或更高版本。
• uv 包管理器。

安装 uv

第一步是安装 Python 包管理器 uv。
可以通过命令行安装。

在 macOS 和 Linux 上：

curl -LsSf https://astral.sh/uv/install.sh | sh

在 Windows 上：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

你也可以通过 pip 安装：

pip install uv

如需了解更多关于安装 uv 的信息，请访问 uv 文档。

使用 Docker 安装

你也可以使用 Docker 运行 AEMET-MCP：

前置条件

• 系统中已安装 Docker

步骤

1. 构建 Docker 镜像：

docker build -t aemet-mcp .

2. 运行容器：

docker run -e AEMET_API_KEY=YOUR_AEMET_API_KEY aemet-mcp

将 YOUR_AEMET_API_KEY 替换为你的实际 AEMET API 密钥。

使用 Docker 与 Claude Desktop 集成

若要在 Claude Desktop 中使用 Docker 版本，请将以下配置添加到 claude_desktop_config.json：

"aemet_mcp_docker": {
    "command": "docker",
    "args": [
        "run",
        "--rm",
        "-i",
        "-e", "AEMET_API_KEY=YOUR_AEMET_API_KEY",
        "aemet-mcp"
    ]
}

与 Claude Desktop 等客户端集成

安装好 uv 后，你可以在任何兼容客户端中使用 MCP 服务，例如 Claude for Desktop。具体步骤如下：

1. 前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json
2. 在 "mcpServers" 中添加以下代码块：

"aemet_mcp_": {
    "command": "uvx",
    "args": [
        "aemet_mcp"
    ],
    "env": {
        "AEMET_API_KEY": "YOUR_AEMET_API_KEY"
    }
}

3. 从 AEMET 获取免费 API 密钥：https://opendata.aemet.es/centrodedescargas/altaUsuario
4. 将 YOUR_AEMET_API_KEY 替换为你的实际 API 密钥（保留引号）。
5. 如果你已配置其他 MCP 服务，请用逗号 , 分隔。

要将其集成到 Cursor、CODEGPT 或 Roo Code 等其他兼容 MCP 的客户端，只需前往客户端的 MCP 服务配置，并添加相同的代码块。

使用示例

正确配置后，你可以提出以下问题：

• “塞维利亚的天气怎么样？”
• “列出马拉加省的海滩”
• “告诉我明天马斯帕洛马斯海滩的辐射水平”
• “提供阿尔瓦塞特在 2020 年 1 月 1 日至 2020 年 2 月 1 日期间的历史降雨数据”
• “列出坐标 lat:40.4165、lon:-3.70256 周围 50 km 范围内的气象站”

降雨数据分析

该服务包含一个专门用于分析西班牙市镇历史降水数据的提示词。使用 obtener_datos_lluvia_municipio 提示词：

obtener_datos_lluvia_municipio("Madrid", "2023-01-01", "2023-12-31")

此提示词为气象分析提供了结构化指导，包括：

• 市镇代码搜索与验证
• 最近气象站的识别
• 历史降水数据检索
• 统计分析与趋势识别
• 季节变化的气候模式分析
• 数据可视化建议

分发平台

Smithery

Glama

MseeP

MCP Review

MCP review 认证