气候数据存储（CDS）MCP 服务器

概述

一个模型上下文协议（MCP）服务器的实现，为大型语言模型提供接口以获取CDS目录数据和任务状态。底层 API 是 datapi，文档可在此处找到。

功能

• 工具：

  • get_jobs：查找可用的任务，可选根据状态添加过滤器。返回任务 ID 列表。
  • download_job_result：使用任务 ID 下载任务结果。
  • get_all_collections：获取目录中所有可用集合的 ID。
  • get_collection_by_id：通过指定的集合 ID 获取相关信息。
  • submit_job：提交一个下载请求。

• 环境变量支持，使用 .env 文件。

先决条件

• Python 3.13 或更高版本。
• CDS API 密钥：此处获取。
• MCP 主机/客户端：已在 Claude 桌面和 MCP 监视器上测试过。

安装

• 克隆仓库：

git clone git@github.com:albertdow/mcp-datapi.git
cd mcp-datapi

• 安装依赖（使用 uv）：

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

• 通过创建 .env 文件并添加以下内容设置 CDS API 密钥：

DATAPI_URL=<DATAPI_URL>
DATAPI_KEY=<DATAPI_KEY>

有关 CDS API 密钥设置的详细信息，请参见此处。

使用方法

开发模式与 MCP 监视器

在本地测试服务器：

mcp dev datapi_server.py

集成到 Claude 桌面

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

或直接添加到 claude_desktop_config.json 中：

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

注意：

• 我需要指定 uv 的路径，例如 /Users/username/.local/bin/uv。