AEMET-MCP. Integration via MCP with the AEMET API

DESCRIPTION

AEMET is the State Meteorological Agency of Spain.

Aemet-mcp allows you to retrieve historical climate data and meteorological information from the AEMET API directly from Claude AI and other MCP compatible clients, using the Model Context Protocol (MCP).

Aemet-mcp is an MCP server that exposes tools enabling LLMs to query data from weather stations across Spain.

It includes secure handling of API keys and resource JSON files for using supporting data.

KEY FEATURES

• Query for historical daily values (temperature, wind, precipitation, etc.)
• Access to monthly climate summaries by station.
• Filtering by year, month, and AEMET station code.
• Query beach conditions, including ultraviolet radiation indices.
• Rainfall data analysis prompt for Spanish municipalities with historical precipitation data
• Responses ready for use in JSON format.

INSTALLATION

Installing via Smithery

To install AEMET Weather Data Server for Claude Desktop automatically via Smithery:

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

Install with uv

Prerequisites

• Python 3.10 or higher.
• uv package manager.

Installing uv

The first step is to install uv, a package manager for Python.
It can be installed from the command line.

On macOS and Linux:

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

On Windows:

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

You can also install it with pip:

pip install uv

For more information about installing uv, visit the uv documentation.

Install with Docker

You can also run AEMET-MCP using Docker:

Prerequisites

• Docker installed on your system

Steps

1. Build the Docker image:

docker build -t aemet-mcp .

2. Run the container:

docker run -e AEMET_API_KEY=YOUR_AEMET_API_KEY aemet-mcp

Replace YOUR_AEMET_API_KEY with your actual API key from AEMET.

Integration with Claude Desktop using Docker

To use the Docker version with Claude Desktop, add this configuration to your claude_desktop_config.json:

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

INTEGRATION WITH CLIENTS LIKE CLAUDE DESKTOP

Once uv is installed, you can use the MCP server from any compatible client such as Claude for Desktop, in which case the steps to follow are: