Earthscope Fdsn

@pipeworx/earthscope-fdsn

国際的なFDSNウェブサービス標準を通じて提供される、地震観測点のメタデータ、連合波形データの保有状況、地域の地震カタログです。

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

これは地震学の観測機器側のものであり、世界の地震カタログではありません。usgs-earthquakes と emsc はすでに「どのような地震が発生したか」をカバーしています。ここでの fdsn_events は、世界のカタログには掲載されない、地域のマグニチュード1～3の地震活動を記録した地域機関のカタログを追加します。

ツール

• fdsn_stations(network?, station?, channel?, level?, lat/lon/radius or bbox, …) — 地震計の設置場所、記録内容、運用者、稼働期間を調べます。
• fdsn_events(datacenter?, starttime?, min_magnitude?, …) — 地域機関の 地震カタログ：gfz（世界規模の迅速な解）、ingv（イタリア）、 resif（フランス）、koeri（トルコ）。
• fdsn_availability(network, station?, channel?, starttime?, endtime?) — どのFDSN データセンターが、指定したチャンネルと時間範囲の波形データを保有しているかを、 各センターのdataselect URLとともに返します。

認証

不要です。

データソース

• https://service.earthscope.org/fdsnws/station/1/query — 観測点のメタデータ。
• https://service.earthscope.org/irisws/fedcatalog/1/query — 連合データの保有状況。
• https://geofon.gfz.de/fdsnws/event/1/query、https://webservices.ingv.it/fdsnws/event/1/query、 https://api.franceseisme.fr/fdsnws/event/1/query、 http://www.koeri.boun.edu.tr/services/fdsnws/event/1/query — 地域カタログ。

次の担当者が再発見することになる情報（すべて2026-09-17に確認済み）

• service.iris.edu は service.earthscope.org に301リダイレクトします。 どちらも動作しますが、 古いホストでは呼び出しごとにリダイレクトが発生するため、新しいホストを直接使用します。
• EarthScope が /fdsnws/ で提供しているのは station と dataselect のみです。 event と availability サービスはHTTP 404を返します。AvailabilityはEarthScopeログインの背後にあります。 末尾にスラッシュの付いたパスにリダイレクトされ、そのパスは vary: Cookie を付けて uvicorn が提供します。そのため、fdsn_availability は代わりに irisws/fedcatalog から回答します。認証不要で、単一のデータセンターではなく、 連合内のすべてのデータセンターについて同じ保有状況を確認できます。
• nodata=404 を指定すると、空の結果と廃止されたエンドポイントを区別できません。 どちらも 本文のない404になり、実際、廃止されたeventサービスを「地震なし」と誤認しかけました。 これらのツールは nodata=204 を送信するため、結果が空の場合は204となり、 404はルートが存在しないことを意味します。
• フィールド名は level=station と level=channel で異なります。 また、深度の列名は 機関によって Depth/km または Depth/Km となるため、行の読み取りには位置ではなく、 エイリアスを使ってヘッダー名を参照します。
• fedcatalog の応答は、FDSNテキストではなく独自の format=request 形式です。 空行で区切られたブロックで、各ブロックは KEY=value 形式のサービス行で始まり、 その後に NET STA LOC CHA START END 形式の行が続きます。
• FDSNの maxradius の単位はkmではなく、角度（度）です。 ツールはkmを受け取り、 度に変換します（÷ 111.195）。

クイックスタート

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

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

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

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

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/fdsn_stations \
  -H 'Content-Type: application/json' \
  -d '{"network":"IU","station":"ANMO","level":"channel","channel":"BH*"}'

最初の呼び出しにはアカウントは必要ありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/fdsn_stations を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

または、起動を確認するには、次のコマンドを直接実行してください。

npx -y @pipeworx/mcp-earthscope-fdsn

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Earthscope Fdsn data" })

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

詳細

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

ライセンス

MIT