Copernicus Dataspace

@pipeworx/copernicus-dataspace

EUのCopernicus Data Space Ecosystemが提供する、欧州のSentinelおよびCopernicus Contributing Missionのアーカイブです。エリアと日付でSentinel-1/2/3/5P、Copernicus DEM、土地被覆および焼失地域の製品を検索し、アイテムID、フットプリント、日付、製品アセットのパスを取得できます。

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

ツール

• copernicus_dataspace_collections(contains?, prefix?, limit?) — ライセンス、範囲、日付範囲を含む製品コレクションです。最初に呼び出してください。コレクションが指定されていない検索クエリは拒否されます。
• copernicus_dataspace_collection(collection_id) — 1つのコレクションの全情報です。
• copernicus_dataspace_search(collections, bbox?, datetime?, ids?, limit?, max_assets?) — 指定した日付に、どの製品がエリアをカバーしているかを検索します。

認証

カタログ検索にキーは不要です。**製品のダウンロードには必要です。**アセットのhrefはs3://eodata/...形式のオブジェクトストレージパスであり、データの取得には無料のCopernicusアカウントとS3またはODataの認証情報が必要です（https://dataspace.copernicus.euで登録してください）。ここで返されるID、日付、フットプリント、アセット一覧は完全で、アカウントは不要です。

関連パック

sentinel-hubパックは、Sentinel Hubの商用処理APIです（OAuthクライアント認証情報を使用し、統計／NDVIエンドポイントが計算済みの値を返します）。このパックはその下位にある無料のEUカタログで、存在するシーンを示します。Sentinel Hubはそれらを描画・分析します。どちらも、もう一方の代わりにはなりません。

データソース

• https://catalogue.dataspace.copernicus.eu/stac — STAC API 1.0です。独自のlinksをhttps://stac.dataspace.copernicus.eu/v1にリダイレクトします。どちらも応答します。

共有クライアント：shared/src/stac.ts。planetary-computer、earth-search、meteoswissでも使用されています。

注意点

• collectionsを指定せずにPOST /searchを実行すると、**HTTP 400 CollectionInQuerryIsMissingError**が返されます（上流側での独自のスペルです）。
• **GET /collectionsは一度に10件ずつページを返します。**ページ指定なしで一度だけ読み込むと、10データセットだけのカタログに見えてしまいます。エラーではなく、もっともらしい誤答になります。共有クライアントはrel="next"をたどります。
• アセットのhrefはs3://であり、HTTPSではありません。エージェントがこれをダウンロードURLとして扱うと何も取得できず、リンク切れだと判断します。

クイックスタート

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

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

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

https://gateway.pipeworx.io/copernicus-dataspace/mcpのtools/listは、上の表にあるツールに加えて、共有のPipeworxメタツール（ask_pipeworx、 discover_tools、search_within、remember／recallなど、ゲートウェイ全体で利用できる一連のツール）を返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、そのパック独自のツールとともに、およそ30個の共有ツールが一覧表示されます。接続時のinitialize応答には正確な範囲が記載されており、その日の状況を確認するための正式な情報源です。

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/copernicus_dataspace_collections \
  -H 'Content-Type: application/json' \
  -d '{"contains":"sentinel-2","limit":5}'

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

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

このパッケージはローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントやゲートウェイへの往復通信は不要です。

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

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

npx -y @pipeworx/mcp-copernicus-dataspace

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

ask_pipeworx の使用

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

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

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

詳細

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

ライセンス

MIT