Knmi MCP

🚀 KNMI Weather MCP Server

A fast MCP server that provides real-time weather data from Royal Netherlands Meteorological Institute (KNMI) weather stations. This application fetches the latest 10-minute measurement data for any location from the nearest KNMI weather station.

✨ Features

• Retrieve weather data for any location in the Netherlands.
• Automatically find the nearest KNMI weather station.
• Provide real-time measurement data, including:
  • Temperature
  • Humidity
  • Wind speed and direction
  • Precipitation
  • Visibility
  • Atmospheric pressure
• Natural language explanations of weather conditions.
• Location search functionality.
• Detailed logging.

📋 Prerequisites

• Python 3.10 or higher.
• A KNMI API key (obtain from the KNMI Data Platform).
• The uv package manager.

📦 Installation

1. Clone the repository:

   git clone <repository-url>
   cd knmi-mcp
   

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

   KNMI_API_KEY=your_api_key_here
   

🚀 Quick Start

Using Claude AI

To run this application with Claude AI, execute the following command in the project folder:

uv run fastmcp install src/knmi_weather_mcp/server.py

This will add the following configuration to your Claude configuration file (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json):

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

⚠️ Important Note

If you encounter the following error:

spawn uv ENOENT

Replace the uv command with the full path to the uv command. On *nix systems, you can find it using the which uv command.

Manual Run

For development or standalone use:

uv run fastmcp run src/knmi_weather_mcp/server.py

💻 Usage Examples

Basic Usage

1. what_is_the_weather_like_in

Get a natural language explanation of the current weather conditions at any location.

await what_is_the_weather_like_in("Amsterdam")

2. get_location_weather

Get the raw weather data for a location.

await get_location_weather("Rotterdam")

3. search_location

Search for locations in the Netherlands.

await search_location("Utrecht")

4. get_nearest_station

Find the nearest KNMI weather station to the given coordinates.

await get_nearest_station(52.3676, 4.9041)

📚 Documentation

Logging

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 Source

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 capabilities to deal with the following situations:

• Unset or invalid API keys.
• Failure to connect to the KNMI server.
• Data parsing failures.
• Network issues.