KNMI Weather MCP

View original on GitHub 

A FastMCP server that provides real-time weather data from KNMI (Royal Netherlands Meteorological Institute) weather stations. This application fetches the latest 10-minute measurements from the nearest weather station to any location in the Netherlands.

Features

• Get weather data for any location in the Netherlands
• Automatically finds the nearest KNMI weather station
• Provides real-time measurements including:
  • Temperature
  • Humidity
  • Wind speed and direction
  • Precipitation
  • Visibility
  • Air pressure
• Natural language interpretation of weather conditions
• Location search functionality
• Detailed logging

Prerequisites

• Python 3.10 or higher
• KNMI API Key (get one from KNMI Data Platform )
• uv package manager

Installation

1. Clone the repository:

   git clone <repository-url>
   cd knmi-mcp

2. Create a .env file in the project root:

   KNMI_API_KEY=your_api_key_here

Running the Server

Using Claude AI

To use this application with Claude AI, add the following configuration to your Claude configuration file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "KNMI Weather": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<username>/src/knmi-mcp/src/knmi_weather_mcp",
      "run",
      "--with",
      "fastmcp",
      "--with",
      "httpx",
      "--with",
      "netCDF4",
      "--with",
      "numpy",
      "--with",
      "pandas",
      "--with",
      "pydantic",
      "--with",
      "python-dotenv",
      "--with",
      "xarray",
      "fastmcp",
      "run",
      "server.py"
    ]
  }
}

Note: Update the --directory path to match your local installation.

Manual Running

For development or standalone usage:

cd src/knmi_weather_mcp
uv run --with fastmcp --with httpx --with netCDF4 --with numpy --with pandas --with pydantic --with python-dotenv --with xarray fastmcp run server.py

Available Tools

1. what_is_the_weather_like_in

Get a natural language interpretation of current weather conditions for any location in the Netherlands.

Example:

await what_is_the_weather_like_in("Amsterdam")

2. get_location_weather

Get raw weather data for a location.

Example:

await get_location_weather("Rotterdam")

3. search_location

Search for locations in the Netherlands.

Example:

await search_location("Utrecht")

4. get_nearest_station

Find the nearest KNMI weather station to given coordinates.

Example:

await get_nearest_station(52.3676, 4.9041)

Logging

The application logs are stored in the logs/knmi_weather.log file, providing detailed information about:

• API requests and responses
• Weather data processing
• Error messages
• Debug information

Data Sources

This application uses the KNMI Data Platform API to fetch data from the “Actuele10mindataKNMIstations” dataset, which provides 10-minute interval measurements from all KNMI weather stations in the Netherlands.

Error Handling

The application includes robust error handling for:

• Invalid locations
• API authentication issues
• Network problems
• Data parsing errors
• Missing measurements