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.

• 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 git@github.com: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_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_KEY": ""
            }
        }
    }
}

Note:

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