Climate Data Store (CDS) MCP Server

What is Climate Data Store (CDS) MCP Server?

A Model Context Protocol (MCP) server that gives LLMs an interface to retrieve Copernicus Climate Data Store (CDS) catalogue data and job statuses via the datapi API. It is designed for developers who want to integrate climate data access into AI assistants running on MCP-compatible hosts like Claude Desktop.

How to use Climate Data Store (CDS) MCP Server?

Clone the repository, install dependencies with uv add "mcp[cli]" datapi python-dotenv, then create a .env file with DATAPI_URL and DATAPI_KEY. Test in dev mode with mcp dev datapi_server.py, or integrate with Claude Desktop using mcp install datapi_server.py --name "DatapiServer" -f .env or by adding the server configuration to claude_desktop_config.json.

Key features of Climate Data Store (CDS) MCP Server

• Provides five tools: get_jobs, download_job_result, get_all_collections, get_collection_by_id, and submit_job.
• Environment variable support via .env for API credentials.
• Designed for MCP hosts (Claude Desktop, MCP Inspector).
• Built on the datapi Python library from ECMWF.
• Requires Python 3.13 or higher.

Use cases of Climate Data Store (CDS) MCP Server

• Retrieve all available collection IDs from the CDS catalogue.
• Submit a download request for a specific climate dataset.
• Check the status of submitted jobs and filter by status.
• Download job results using a job ID.
• Integrate climate data retrieval directly into a conversational AI assistant.

FAQ from Climate Data Store (CDS) MCP Server

What are the prerequisites for running this server?

Python 3.13 or higher, a valid CDS API key (obtained from the Copernicus Climate Data Store), and an MCP host/client (tested on Claude Desktop and MCP Inspector).

How do I set up the CDS API key?

Create a .env file in the project root with DATAPI_URL=<your_url> and DATAPI_KEY=<your_key>. Details on obtaining the key are available at the CDS API setup page.

What tools does the server provide?

It provides get_jobs, download_job_result, get_all_collections, get_collection_by_id, and submit_job.

How do I integrate this server with Claude Desktop?

Run mcp install datapi_server.py --name "DatapiServer" -f .env from the project directory, or manually add the server configuration to claude_desktop_config.json with the appropriate uv command and environment variables.

What is the underlying API used by this server?

The server uses the datapi API from ECMWF (European Centre for Medium-Range Weather Forecasts), documented at https://ecmwf-projects.github.io/datapi/.