Earthquake MCP Server
概览
作者提供的说明(英文原文)
Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i4 项中通过 4 项依据公开信息检查;尚未扫描代码
- 使用情况i起步阶段↓ 443/周 · ★ 3
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 电脑或云端
- 传输方式: stdio, Streamable HTTP
- 分类: 搜索与 AI 记忆
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:4 项中通过 4 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 4 件事(工具) earthquake_get_feed, earthquake_search_events, earthquake_get_event, earthquake_count_events
- 需要你自己填写:
MCP_LOG_LEVEL,USGS_BASE_URL,EMSC_BASE_URL,DEFAULT_LIMIT,REQUEST_TIMEOUT_MS,EARTHQUAKE_CLAMP_LIMITS
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://earthquake.caseyjhand.com/mcp或者在你的电脑上运行
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"earthquake": {
"command": "npx",
"args": [
"-y",
"@cyanheads/earthquake-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "your-value",
"USGS_BASE_URL": "your-value",
"EMSC_BASE_URL": "your-value",
"DEFAULT_LIMIT": "your-value",
"REQUEST_TIMEOUT_MS": "your-value",
"EARTHQUAKE_CLAMP_LIMITS": "your-value"
}
}
}
}在终端中运行这条命令
claude mcp add --transport http earthquake https://earthquake.caseyjhand.com/mcp或者在你的电脑上运行
claude mcp add earthquake --env MCP_LOG_LEVEL=your-value --env USGS_BASE_URL=your-value --env EMSC_BASE_URL=your-value --env DEFAULT_LIMIT=your-value --env REQUEST_TIMEOUT_MS=your-value --env EARTHQUAKE_CLAMP_LIMITS=your-value -- npx -y @cyanheads/earthquake-mcp-server运行前请先填写空着的值。
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"earthquake": {
"url": "https://earthquake.caseyjhand.com/mcp"
}
}
}或者在你的电脑上运行
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"earthquake": {
"command": "npx",
"args": [
"-y",
"@cyanheads/earthquake-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "your-value",
"USGS_BASE_URL": "your-value",
"EMSC_BASE_URL": "your-value",
"DEFAULT_LIMIT": "your-value",
"REQUEST_TIMEOUT_MS": "your-value",
"EARTHQUAKE_CLAMP_LIMITS": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"earthquake": {
"type": "http",
"url": "https://earthquake.caseyjhand.com/mcp"
}
}
}或者在你的电脑上运行
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"earthquake": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/earthquake-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "your-value",
"USGS_BASE_URL": "your-value",
"EMSC_BASE_URL": "your-value",
"DEFAULT_LIMIT": "your-value",
"REQUEST_TIMEOUT_MS": "your-value",
"EARTHQUAKE_CLAMP_LIMITS": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://earthquake.caseyjhand.com/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
需要你填写的值
MCP_LOG_LEVELenvSets the minimum log level for output (e.g., 'debug', 'info', 'warn').USGS_BASE_URLenvUSGS API base URL. Override for testing or mirroring.EMSC_BASE_URLenvEMSC API base URL. Override for testing or mirroring.DEFAULT_LIMITenvEvents earthquake_search_events returns when a call omits limit (1-1000).REQUEST_TIMEOUT_MSenvPer-attempt HTTP timeout in milliseconds (1000-120000). Every feed, search, count, and event call also runs under one 50-second total deadline across its requests and retries.EARTHQUAKE_CLAMP_LIMITSenvClamp a search or feed limit above 1000 to 1000 with a notice. Set false to advertise and enforce a maximum of 1000 instead.
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
工具名称和描述与服务器在 2026年11月10日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
earthquake_get_feedFetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window. These feeds are CDN-cached by USGS and faster and more available than the query API — use them for "what's happening now" queries. "all" includes microseisms (M<1); "significant" is a USGS cura
earthquake_search_eventsSearch USGS or independent global EMSC seismic catalogs by time, magnitude, depth, area and source-specific filters. Both include non-tectonic events; event_type="earthquake" excludes them on USGS. Circle and independently optional box edges intersect. Unsupported EMSC filters ap
earthquake_get_eventFetch one earthquake by event ID: a USGS ID, or an EMSC ID (an origin date and seven-digit sequence, e.g. "20190706_0000043"). Returns the same normalized event a search result carries. For a USGS event it adds a projection of the analysis products only the single-event response
earthquake_count_eventsCount matches without event records, or size an earthquake_search_events query. Omitting start_time uses 30 days; pass explicit bounds for historical periods. queryEcho reports applied filters/window; ignoredFilters names unsupported EMSC inputs. Circle and independently optional
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 cyanheads 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于6天前
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 113 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 4 个工具描述,未发现针对 AI 的隐藏指令
与“搜索与 AI 记忆”中的其他服务器比较i
- 星标数多于此分类中其他 5866 个服务器的 84%
- 发布到注册中心的时间比此分类中其他 5866 个服务器的 85% 更新
- 基础检查结果等于或优于此分类中其他 5866 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Earthquake MCP Server 安全吗?
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
两种方式都可以:安装在你的电脑上,或者连接云端版本。
它还在维护吗?
GitHub 仓库最后更新于6天前,最新版本(0.5.1)于6天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:Ruflo, Context7, Metabase
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
@cyanheads/earthquake-mcp-server Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts via MCP. STDIO or Streamable HTTP. 4 Tools • 3 Resources
Public Hosted Server: https://earthquake.caseyjhand.com/mcp
Overview
Seismic data from USGS ComCat and the EMSC SeismicPortal. Fetch real-time earthquake feeds, search and count seismic events by time, magnitude, depth, and location, and pull full analysis detail for a single event.
Tools
| Tool | Description |
|---|---|
earthquake_get_feed | Fetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window |
earthquake_search_events | Search earthquakes by time range, magnitude, depth, location radius, PAGER alert level, felt reports, or ShakeMap and DYFI intensity |
earthquake_count_events | Count earthquakes matching filters without fetching full records |
earthquake_get_event | Fetch one earthquake by USGS or EMSC event ID, with USGS analysis products and opt-in origins, magnitudes, phase arrivals, aftershock forecast, and PAGER loss estimates |
Resources
| Resource | Description |
|---|---|
earthquake://feed/{magnitude_tier}/{time_window} | First 100-event page of a USGS real-time feed, with an exact continuation URI |
earthquake://feed/{magnitude_tier}/{time_window}/page/{cursor} | Continue the retained feed generation using the returned next_uri |
earthquake://event/{event_id} | One earthquake by USGS or EMSC event ID as injectable context, with the same detail product projection as earthquake_get_event |
Skill
| Skill | Description |
|---|---|
earthquake-guide | Agent guide for the earthquake_* tools: identifier chains between USGS and EMSC, coverage and magnitude-scale gates, and when product and include groups answer a question. Loaded by plugin hosts from skills/ and served over MCP as skill://earthquake-guide/SKILL.md |
Capability reference
earthquake_get_feed tool
- Choose a magnitude tier (
all,1.0,2.5,4.5,significant) and a window (hour,day,week,month). USGS caches these feeds; useearthquake_search_eventsfor historical or filtered queries. - Returns events, page count, generation time, and source feed URL.
allincludes microseisms;significantis USGS-curated using magnitude, felt reports, and PAGER impact. - Each page returns
limitevents (default 15), fewer only on the last page. Alimitabove 1,000 returns 1,000 with a notice naming the requested and applied values; withEARTHQUAKE_CLAMP_LIMITS=falseit is rejected instead.limitapplies to the first page; later pages keep the page size in the cursor.totalCountreports the whole feed; passnextCursorback unchanged with the same tier and window. - Continuations read the first-read generation, unaffected by upstream edits. Retention lasts up to 15 minutes, subject to capacity eviction and restart.
cursor_expiredmeans restart without a cursor; legacy cursors must also be restarted.
earthquake_search_events tool
- Search
usgsoremscby time, magnitude, depth, radius, or bounding box. A radius requireslatitude,longitude, andradius_kmtogether; box edges are independently optional, support antimeridian bounds up to ±360°, and intersect a supplied circle. - Returns normalized events with
event_type, EMSC'sevent_certainty, and USGS'sassociated_ids(other network IDs merged into the event).ignoredFiltersnames unsupported filters;queryEchoreports the effective query. - Both search and count accept open
magnitude_typevalues on either source; EMSC matches its own lowercase types (mb,mw) exactly and has nomww.product_type(required product, e.g.moment-tensor) andreview_status(automaticorreviewed) apply only to USGS; EMSC names them inignoredFilters. Blank values mean omitted. event_type,magnitude_type, andproduct_typestay open strings; USGS matches them case-insensitively, andevent_typetakes a comma-separated list. USGS answers a value outside its published vocabulary with zero events, so when a USGS search's first page or a USGS count comes back empty,noticenames each unlisted value and the listed values it equals once case and-,_, and spaces are ignored:product_type "moment_tensor"suggests"moment-tensor". The vocabulary read is one attempt within the call's deadline, cached for 24 hours; if it fails, the zero returns as it would without the check. EMSC publishes no vocabulary and is not checked.min_mmi(ShakeMap intensity, Modified Mercalli) andmin_cdi(DYFI community intensity), each 1–12, select events by how strongly they shook, which a magnitude floor oralert_levelmisses. Both apply only to USGS: an event without a ShakeMap or DYFI reports never matches, and EMSC names them inignoredFilters.- Date-only bounds (including expanded year/year-month forms) mean midnight at the start of the named day on both sources:
2026-10-10becomes2026-10-10T00:00:00. Explicit time and timezone suffixes are preserved; unpadded date components are padded. Offsetless times use UTC for the 30-day default.queryEchoshows the exact effective bounds. - Sort by time or magnitude in either direction. Each call requests
limitevents upstream (default 15, set byDEFAULT_LIMIT) and returns them all, fewer only on the last page. Alimitabove 1,000 returns 1,000 with a notice naming the requested and applied values; withEARTHQUAKE_CLAMP_LIMITS=falseit is rejected instead.queryEcho.limitreports the applied limit. Continue with the returnednextOffset(offset plus the events returned, counting from 1) and the same filters, limit, and order. Search pages read the current catalog, so upstream edits can affect later pages. - Strictly inverted magnitude, depth, or explicit time bounds fail locally as
invalid_range, naming both values and recovery. Equal and single bounds remain valid; time comparisons use UTC instants, including explicit offsets. Calendar-invalid values remain for upstream rejection. - A nonempty short page establishes
totalCount; an empty first page establishes zero, while an empty later page leaves the total unknown. Full pages use a count lookup, withcountUnavailableon failure. Feed, search, count, and event calls each share one 50-second deadline across their requests and retries; for search that includes the count lookup. Cancellation remains cancellation.
earthquake_count_events tool
- Count matches using the same filters as
earthquake_search_events, without fetching events. Omitstart_timefor the last 30 days;queryEchoreports the resolved window and applied filters. exceeds_limitflags the 20,000-event single-request threshold, not a retrieval ceiling: search offset paging can retrieve larger match sets.max_allowedis 20,000 for USGS and null for EMSC;ignoredFiltersnames filters the source cannot apply.- A USGS count of zero carries
noticewhen a suppliedevent_type,magnitude_type, orproduct_typevalue is not in the USGS vocabulary, as search's empty first page does.
earthquake_get_event tool
- Pass the
idof any feed or search result. An EMSC unid from asource=emscsearch (eight digits, underscore, seven digits, e.g.20190706_0000043) is looked up on EMSC SeismicPortal; every other ID goes to USGS (e.g.us6000sznj). - A USGS event returns the normalized event plus optional
detail: PAGER, ShakeMap, DYFI, moment tensor, ground-failure alerts, origin quality (includingdepth_type, which separates an assigned depth from a located one), and finite-fault dimensions. Groups are omitted when none of their projected fields is available; absence does not imply zero impact.associated_idslists the other network IDs USGS holds for the event; an alias such asus70004bn0returns the preferred event (ci38457511) with the alias listed there. - An EMSC event returns the same normalized event its search result carries, with no
detailand noassociated_ids. includeopts into more for USGS events:
| Group | Source | Extra requests |
|---|---|---|
origins | Every origin product in the event response, preferred first | None |
magnitudes | Event-level magnitudes from the preferred phase-data product's QuakeML, with a station count where published | One, shared with arrivals |
arrivals | Every phase arrival of that document's preferred origin, joined to its pick and sorted nearest first | One, shared with magnitudes |
aftershock_forecast | The USGS Operational Aftershock Forecast: each window's probability of an aftershock at or above each magnitude, its expected-count range, and the chance of one as large as the mainshock | One |
pager | The PAGER estimates behind the alert, from the preferred losspager product's JSON files: the fatality and economic-loss alert levels with every probability bracket (economic bounds in millions of USD), PAGER's impact statements, and the people exposed at each shaking intensity, in total and per country | Two, or three when the product publishes impact statements |
- A requested group that is not returned is listed in
unavailable_includes:not_publishedwhen the event has no such product (every group on an EMSC event) or its product lacks the files the group reads (PAGER products published before the JSON files existed),fetch_failedwhen the download failed, returned HTML, did not parse, pointed outside the configured USGS origin, or answered with a redirect. The event,detail, and other groups still return; cancellation propagates. The event request and its product downloads share one 50-second deadline. - Blank IDs fail locally