Climate Data Store (CDS) MCP Server

Climate Data Store（CDS）MCP サーバー

概要

LLM に CDS のカタログデータとジョブのステータスを取得するインターフェースを提供する、Model Context Protocol（MCP）サーバーの実装です。 基盤となる API は datapi です。ドキュメントはこちらをご覧ください。

機能

• ツール：

  • get_jobs：利用可能なジョブを検索します。必要に応じてステータスでフィルターを追加できます。 ジョブ ID のリストを返します。
  • download_job_result：ジョブ ID を使ってジョブの結果をダウンロードします。
  • get_all_collections：カタログで利用可能なすべてのコレクション ID を取得します。
  • get_collection_by_id：指定したコレクションの情報を取得します。
  • submit_job：ダウンロードリクエストを送信します。

• .env を使った環境変数のサポート。

前提条件

• Python 3.13 以降。
• CDS API キー：こちら
• MCP ホスト／クライアント：Claude Desktop と MCP Inspector でテスト済みです。

インストール

• リポジトリをクローンします：

git clone [email protected]: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 Inspector を使った開発モード

サーバーをローカルでテストします：

mcp dev datapi_server.py

Claude Desktop との統合

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

または、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>"
            }
        }
    }
}

注：

• uv へのパスを指定する必要がありました。例：/Users/username/.local/bin/uv。