Earth Search

@pipeworx/earth-search

Element 84 の Earth Search が AWS Open Data レジストリ上で提供する Sentinel および Landsat の画像カタログです。エリアと日付で Sentinel-1/2、Landsat Collection 2、NAIP、Copernicus DEM を検索し、アイテム ID、フットプリント、雲量、クラウド最適化 GeoTIFF の URL を取得できます。

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

ツール

• earth_search_collections(contains?, prefix?, limit?) — インデックス化されているミッションと、そのライセンス、範囲、日付範囲です。
• earth_search_collection(collection_id) — 1 つのコレクションの詳細です。アイテムが持つアセットキー（バンド、サムネイルなど）も含まれます。
• earth_search_search(collections?, bbox?, datetime?, ids?, limit?, max_assets?) — 指定した日付のエリアをカバーするシーンを検索します。兄弟カタログとは異なり、ここでは collections は省略可能です。

認証

キーは不要です。メタデータもアセットも取得できます。URL はトークンもアカウントもなしで AWS Open Data 上で解決されます。メタデータではなくデータ本体が必要な場合に、呼び出し元を案内するカタログです。一部のバケットは、https:// ではなく s3:// 経由で読み取る場合、リクエスター支払いが必要です。

データソース

• https://earth-search.aws.element84.com/v1 — STAC API 1.0。

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

注意点

• このセットの中で、カタログ全体を対象に検索できるのはこのカタログだけです。 Planetary Computer（422）と Copernicus Data Space（400）は、collections を指定しない検索をどちらも拒否します。「ここに画像はあるか」を調べるのに便利ですが、検索結果には解像度が大きく異なるミッションが含まれるため、比較する前に各アイテムの collection を確認してください。
• コレクション ID は互換性がありません。Sentinel-2 L2A は、ここでは Collection 1 で再処理された sentinel-2-c1-l2a、旧ベースラインの sentinel-2-pre-c1-l2a ですが、Planetary Computer と Copernicus Data Space では同じミッションが sentinel-2-l2a です。誤った ID を指定してもエラーにはならず、結果が空になります。

クイックスタート

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

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

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

https://gateway.pipeworx.io/earth-search/mcp の tools/list は、上の表のツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で使えるツール群）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに共有ツールがおよそ 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の時点での確定情報です。

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

このパックのツールだけでなく、各パックのツールをすべて直接一覧表示するには、Pipeworx のフルゲートウェイに接続します。

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

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

MCP クライアントがない場合：HTTP で呼び出す

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

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

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

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

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

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

npx -y @pipeworx/mcp-earth-search

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Earth Search data" })

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

詳細

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

ライセンス

MIT