Climate Data Store (CDS) MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides the LLM an
interface to retrieve CDS catalogue data and job statuses.
The underlying API is datapi - docs found here.

Features

- Tools:
- get_jobs: find the jobs available, optionally add a filter based on status.
Returns a list of job ids.
- download_job_result: downloads the job result using job id.
- get_all_collections: gets all available collection ids in the catalogue.
- get_collection_by_id: fetches information for a specified collection.
- submit_job: submits a download request.

- Environment variable support using .env.

Prerequisites

- Python 3.13 or higher.
- CDS API Key: here
- MCP Host/Client: tested on Claude Desktop and the MCP Inspector.

Installation

- Clone the repository:

git clone [email protected]:albertdow/mcp-datapi.git
cd mcp-datapi

- Install dependencies (using uv):

uv add "mcp[cli]" datapi python-dotenv

- Setup CDS API key by creating a .env file and adding the following:

DATAPI_URL=<DATAPI_URL>
DATAPI_KEY=<DATAPI_KEY>

Details on CDS API key setup can be found here.

Usage

Dev Mode with MCP Inspector

Test the server locally:

mcp dev datapi_server.py

Integrate with Claude Desktop

mcp install datapi_server.py --name "DatapiServer" -f .env

Or directly put add to your claude_desktop_config.json:

{
    "mcpServers": {
        "DatapiServer": {
            "command": "uv",
            "args": [
                "--directory",
                "mcp-datapi",
                "run",
                "mcp_datapi/datapi_server.py"
            ],
            "env": {
                "DATAPI_URL": "<DATAPI_URL>",
                "DATAPI_KEY": "<DATAPI_KEY>"
            }
        }
    }
}

Note:

- I had to specify the path to uv, e.g. /Users/username/.local/bin/uv.