Copernicus Cds

@pipeworx/copernicus-cds

Copernicus Climate Data Store（C3S/ECMWF）のカタログです。ERA5、CMIP6/CORDEX の予測、衛星による必須気候変数、季節予報を支える、公開済みの約 140 件の気候データセットに加え、任意のデータセットに対して取得ジョブを送信できます。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認や公開も受けていません。

ツール

• cds_collections(query?, limit?, offset?) — カタログを一覧表示するか、キーワードで検索します。コレクション ID、タイトル、概要の冒頭、時間的・空間的範囲を返します。キーは不要です。
• cds_collection(collection_id, include_form?) — 1 件のコレクションの全情報を取得します。STAC レコード（概要、ライセンス、キーワード、範囲、ドキュメントへのリンク）に加え、取得リクエストフォームを返します。フォームには、ジョブで指定できる変数、年、レベル、範囲、出力形式が記載されています。キーは不要です。
• cds_submit_request(collection_id, inputs, _apiKey) — 非同期の取得ジョブを送信し、ジョブ ID を返します。呼び出し元のキーが必要です。
• cds_job_status(job_id, _apiKey) — 送信したジョブのステータス（accepted、running、successful、failed）とタイムスタンプを返します。不明な ID の場合は found:false を返します。
• cds_job_result(job_id, _apiKey) — ジョブが成功した後、種類、サイズ、有効期限とともにダウンロードリンクを返します。実行中のジョブでは空の結果を返さず、ステータスとともに ready:false を返します。送信時と同じ呼び出し元のキーを使用します。

認証

カタログの閲覧にはキーは不要で、この動作は 2026-09-17 時点で確認済みです。取得ジョブの送信には、無料の CDS Personal Access Token が必要です。_apiKey として渡してください。

プラットフォームキーは設定されていません。設定される場合に使用する環境変数は PLATFORM_CDS_KEY です。https://cds.climate.copernicus.eu で登録してください。

キーが未設定の間、このパックのマニフェストエントリでは platformKeyEnv を意図的に宣言していません。これは、ゲートウェイの keyBlockedTools() が、プラットフォームキーを宣言していてそのシークレットが未設定のパックでは、すべてのツールをブロックするためです。その結果、現在利用できるキー不要のカタログツール 2 つまで使えなくなります。キーが必要なツールでは _apiKey を必須として宣言しているため、ルーティングでブロックされるのはそのツールだけです。シークレットを設定するのと同じ変更で、パックマニフェストのエントリに "platformKeyEnv": "PLATFORM_CDS_KEY" を追加してください。

copernicus-dataspace との違い

copernicus-dataspace は EU Copernicus Data Space Ecosystem であり、Sentinel 衛星の画像カタログ（catalogue.dataspace.copernicus.eu）です。このパックは Climate Data Store（cds.climate.copernicus.eu）で、モデル化された気候変数や衛星から得られた気候変数を扱います。同じプログラムですが、ホストも用途も異なります。

データソース

• https://cds.climate.copernicus.eu/api/catalogue/v1/collections — STAC コレクションの一覧です。カタログ全体を 1 回の応答で返し、limit と q は無視します。そのため、cds_collections のキーワードフィルターとページ分割は、上流ではなくこのツール内で適用されます。
• https://cds.climate.copernicus.eu/api/catalogue/v1/collections/{id} — 1 件の STAC コレクションです。
• https://cds.climate.copernicus.eu/api/retrieve/v1/processes/{id} — OGC API プロセスの説明です。キーは不要です。リクエストフォームはここにあり、STAC レコードだけでは取得時に指定できる内容はわかりません。
• https://cds.climate.copernicus.eu/api/retrieve/v1/processes/{id}/execute — ジョブの送信先です。認証には Bearer トークンやクエリパラメーターではなく、PRIVATE-TOKEN ヘッダーを使います。認証なしの場合は 401 "authentication required" が返り、無効なトークンの場合は 401 "Authentication failed" が返ります。この 2 つは区別できます。

CDS のウェブサイトでデータセットのライセンスに同意することは、トークンを所持することとは別の条件です。アカウントが利用規約に同意していないデータセットでは、有効なトークンを使っても 403 が返ります。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "copernicus-cds": {
      "url": "https://gateway.pipeworx.io/copernicus-cds/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/copernicus-cds/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共通ツールが約 30 個表示されます。接続の initialize 応答に正確な範囲が示されており、その日の状況についてはこれが正式な回答となります。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断して振り分ける ask_pipeworx 経由で回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。メタツールなしでパックのエンドポイントをマウントする方法は、現時点ではありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1879 以上のデータソースにアクセスします。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/cds_collections \
  -H 'Content-Type: application/json' \
  -d '{"query":"sea ice","limit":5}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/cds_collections を実行してください。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "copernicus-cds": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-copernicus-cds"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-copernicus-cds

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールであり、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックエンドポイントでも、ゲートウェイ全体でも使えます。

ask_pipeworx({ question: "your question about Copernicus Cds data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

その他

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT