MCP Datapi

🚀 氣候數據存儲（CDS）MCP 服務器

本項目實現了一個模型上下文協議（MCP）服務器，為大型語言模型提供接口，使其能夠獲取 CDS 目錄數據和任務狀態。底層 API 為 datapi，相關文檔可在此處查看。

🚀 快速開始

先決條件

• 需安裝 Python 3.13 或更高版本。
• 要獲取 CDS API 密鑰，可前往此處申請。
• MCP 主機/客戶端：本項目已在 Claude 桌面和 MCP 監視器上完成測試。

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴（使用 uv）：

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

3. 設置 CDS API 密鑰： 通過創建 .env 文件並添加以下內容：

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。

✨ 主要特性

工具功能

• get_jobs：可查找可用的任務，還能根據狀態添加過濾器，最終返回任務 ID 列表。
• download_job_result：使用任務 ID 即可下載任務結果。
• get_all_collections：獲取目錄中所有可用集合的 ID。
• get_collection_by_id：通過指定的集合 ID 獲取相關信息。
• submit_job：提交一個下載請求。

環境變量支持

支持使用 .env 文件來設置環境變量。