Earthscope Fdsn

@pipeworx/earthscope-fdsn

通过国际 FDSN Web 服务标准获取地震台站元数据、联合波形数据存量和区域地震目录。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 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 会 301 重定向到 service.earthscope.org。 两者都能使用； 旧主机每次调用都会多一次重定向，因此直接使用新主机。
• EarthScope 仅在 /fdsnws/ 下提供 station 和 dataselect。 它的 event 和 availability 服务会返回 HTTP 404。Availability 需要登录 EarthScope—— 它会重定向到一个由 uvicorn 提供、带有 vary: Cookie 的尾部斜杠路径。 因此，fdsn_availability 改为从 irisws/fedcatalog 获取结果：无需密钥， 而且它会报告所有联合数据中心的数据存量情况，而不只是单个中心。
• nodata=404 会让空结果和已下线的端点无法区分——两者都是不带正文的 404，而已下线的事件服务差点就被误认为“没有地震”。这些工具发送 nodata=204，因此空结果会返回 204，404 则确实表示该路由已不存在。
• level=station 和 level=channel 的字段名称不同，而且一个机构将深度 列命名为 Depth/km，另一个则写作 Depth/Km，因此读取行时会依据带别名的 标题名称，而不是列的位置。
• fedcatalog 使用自己的 format=request 方言返回结果，而非 FDSN 文本： 各数据块以空行分隔，每个数据块先以 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——无需再添加第二个 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