Iran Earthquakes

面向 AI Agent

• **简介：**面向伊朗地震的非官方 MCP 服务（模型上下文协议）。数据源：USGS ComCat（source="usgs"，默认）、通过 SeismicPortal 获取的 EMSC 数据（source="emsc"）和伊朗地震中心（source="irsc"，仅包含其最新约 20 条事件，并提供省份名称）。不同数据源不会合并；它们的事件 ID 各不相同。
• 安装：uvx iran-quake-mcp 或 claude mcp add iran-quake -- uvx iran-quake-mcp。传输方式：stdio。需要安装 uv（Python 3.10+）。
• **身份验证：**无需身份验证、API 密钥或账户。可选设置 IRAN_QUAKE_MCP_PROXY（HTTP 代理 URL 或逗号分隔的列表）；系统代理设置会被忽略。
• **访问权限：**只读。无法写入或订阅，因此调用任何工具前都无需确认。
• **工具：**共 5 个，名称均以 eq_ 开头。典型调用顺序：eq_latest 或 eq_significant -> 使用列表中的 ID 调用 eq_detail。按日期范围、边界框或地点搜索时使用 eq_search；查询数量时使用 eq_stats。
• **适用场景：**用户询问伊朗近期或过去的地震、最强地震、某个省份或城市附近的地震，或某个时期的地震活动情况时。
• **不适用场景：**用户需要官方警告或警报（这不是预警服务；请参阅伊朗地震中心 irsc.ut.ac.ir），或询问伊朗及其邻国以外的地震时。
• 单位：time_utc（UTC）和 time_tehran（UTC+03:30，不实行夏令时）；搜索日期使用 UTC；depth_km 的单位为千米；mag_type（mb、ml、mw……）表示震级类型。
• **回复：**每次调用最多返回 50 条事件（limit 为 1-50），最多约 12 KB，不超过 15 KB。
• 机器可读信息：server.json 和 iran-mcp 目录。

为什么

地震数据源是为地震学家设计的：服务器各不相同，ID 格式不同，时间戳使用 UTC，也没有省份字段。要问“本周克尔曼附近有没有 4.5 级以上地震？这个月伊朗最强的一次是什么？”，就得查询地图或搜索表单，还要手动换算时间。使用 iran-quake-mcp，Agent 只需调用几次工具就能回答，并给出简短摘要，时间采用德黑兰时间，深度单位为千米。

你： 过去 30 天里，伊朗发生过强震吗？

Agent： 调用 eq_significant(days=30, min_magnitude=5.0) -> 对最大的一次调用 eq_detail(...)

它会按震级从大到小列出事件，并提供震级、地点、深度和德黑兰时间，然后补充最大一次事件的审核状态和有感报告。

每条回复都不超过 15 KB（最大约 12 KB），不会占满 Agent 的上下文。

功能

• 按最低震级和回溯小时数查询伊朗最新地震，按时间从新到旧排列
• 按 UTC 日期范围、震级范围、边界框和地点文本搜索，并按时间或震级排序
• 查询过去 N 天内的最强地震，按震级从大到小排列
• 按 ID 查询单个事件的完整信息：USGS 提供审核状态、有感／震感、海啸标记和质量信息；EMSC 提供机构和更新时间；IRSC 提供最近城镇
• 查询时间范围内的统计数据：按震级区间统计数量、热门地点和最强事件
• 一个服务整合三个数据源：USGS、EMSC 和伊朗地震中心
• 按设计仅支持读取：不会写入数据或订阅内容

示例提示词：

• “显示过去 48 小时内伊朗所有 4 级及以上地震。”
• “过去一年里，伊朗最强的 10 次地震是什么？”
• “这个月克尔曼附近有地震吗？”
• “给我过去 30 天伊朗的地震统计数据。”
• “提供伊朗地震中心数据源中最新一次地震的详情，包括省份。”
• آخرین زلزله‌های ایران در ۲۴ ساعت گذشته کدام‌اند؟
• قوی‌ترین زلزله‌های ماه اخیر در ایران را با عمق و ساعت تهران بده.
• آیا در هفته گذشته در هرمزگان زلزله بالای ۴ ریشتر آمده؟

快速开始

你需要安装 uv。无需 API 密钥或账号。

claude mcp add iran-quake -- uvx iran-quake-mcp

{
  "mcpServers": {
    "iran-quake": { "command": "uvx", "args": ["iran-quake-mcp"] }
  }
}

{
  "servers": {
    "iran-quake": { "type": "stdio", "command": "uvx", "args": ["iran-quake-mcp"] }
  }
}

codex mcp add iran-quake -- uvx iran-quake-mcp

[mcp_servers.iran-quake]
command = "uvx"
args = ["iran-quake-mcp"]

{
  "mcpServers": {
    "iran-quake": { "command": "uvx", "args": ["iran-quake-mcp"] }
  }
}

列表工具（eq_latest、eq_search、eq_significant、eq_stats）可选参数为 source（默认为 usgs、emsc、irsc）和 iran_only（默认为 true）。

这 5 个工具均标注为 readOnlyHint: true。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-quake-mcp  (runs on your machine)
      │
      │  HTTPS (IRSC: plain HTTP)
      ├──────▶  earthquake.usgs.gov   USGS FDSN event API
      ├──────▶  www.seismicportal.eu  EMSC FDSN event API
      └──────▶  irsc.ut.ac.ir         events_list.xml

iran-quake-mcp 在本地运行，并调用 USGS、EMSC 和 IRSC 的公共数据源。中间没有托管服务，也不需要 API 密钥。它每次最多发送 2 个请求，中间加入少量随机延迟，缓存结果 60 秒；GET 请求失败时最多重试 4 次（USGS 偶尔会返回 502）；响应正文大小上限为 5 MB，且只与这三个主机通信。它只读取数据。

须知

• 时间：time_utc 为 UTC，time_tehran 为 UTC+03:30（自 2022 年起不再实行夏令时）。搜索日期均为 UTC。深度字段为 depth_km，数值为正。
• **震级：**类型在 mag_type 中（mb、ml、mw 等）。不同类型或数据源的数值无法完全直接比较。
• **数据源相互独立：**结果不会合并或去重，ID 也各不相同。eq_detail 只接受事件 ID，并根据其格式识别数据源：EMSC 的 ID 格式为 20261014_0000009，IRSC 的 ID 为 213549 这类纯数字（仅能在其最近约 20 个事件中找到），其他格式则归为 USGS。
• **默认仅限伊朗境内：**事件必须位于伊朗的大致边界范围内（陆地边界约留出 0.3 度余量，另包括波斯湾、阿曼湾和里海的伊朗水域），且地点文本必须包含伊朗、波斯湾、阿曼湾或里海。边境另一侧的事件会被排除。iran_only=false 则返回 24-40 N、43.5-64 E 范围内的所有事件。
• **地点：**USGS 和 EMSC 没有省份字段（USGS 提供最近的城镇，EMSC 提供地区）。place 可接受省份名称（Tehran、Kerman、Hormozgan、Khuzestan、Fars、Sistan and Baluchestan、Kermanshah、Razavi Khorasan、East Azerbaijan、West Azerbaijan、Bushehr、Mazandaran），并据此选取可能与相邻省份重叠的大致范围。其他文本会按英文、不区分重音符号的子字符串进行匹配。IRSC 的地点格式为 Town, Province。
• **IRSC：**数据读取自 http://irsc.ut.ac.ir/events_list.xml（纯 HTTP；其 HTTPS 已关闭）。该源仅列出最近约 20 个事件，不提供震级类型或历史记录，因此当日期范围延伸到更早时期时，more 为 true。数据仅获准用于非商业和人道主义用途，且必须注明伊朗地震中心（德黑兰大学）。
• 回复大小：limit 最大为 50。如果原始抓取结果达到 3000 行，eq_stats 会将 truncated 设为 true。
• **延迟和修订：**数据源会延迟列出小规模地震，也会在之后修订数值。USGS 的冷查询可能需要约 10 秒。
• **不提供的功能：**不提供警报、推送通知、地震预警、震动地图或损失估算。
• **网络：**如果无法直接访问数据源，请设置 IRAN_QUAKE_MCP_PROXY。系统代理变量会被有意忽略。

常见问题

npx @modelcontextprotocol/inspector uvx iran-quake-mcp

配置

波斯语：伊朗地震 MCP 服务

claude mcp add iran-quake -- uvx iran-quake-mcp

开发

git clone https://github.com/sepehr071/iran-quake-mcp && cd iran-quake-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls the real USGS/EMSC feeds
uv build

所有工具都位于 src/iran_quake_mcp/quakes.py 中；每个工具都是带类型标注的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送 v* 标签。GitHub Actions 会发布到 PyPI。

相关服务

• iran-mcp：伊朗各类服务 MCP 服务目录
• iran-news-mcp：伊朗新闻
• iran-apps-mcp：伊朗应用
• iran-tax-mcp：伊朗税务和 Codal 数据
• tgju-mcp：来自 TGJU 的美元、黄金、金币和大宗商品价格

免责声明

本项目未经授权，与 USGS、EMSC 或伊朗地震中心无关联，也未获其认可。本项目仅供查询。 地震数据仅供参考，可能存在延迟，且来源会对数据进行修订；本项目不提供预警服务。请查看 各来源的使用条款：IRSC 数据仅授权用于非商业、人道主义用途，且必须注明伊朗地震中心（德黑兰大学）。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎在 LinkedIn 上联系，或关注 GitHub 上的 @sepehr071，了解更多面向伊朗网站的 MCP 服务；所有服务都列在 iran-mcp 中。如果这个项目为您节省了时间，请给仓库点个星，帮助其他人发现它。

许可证

MIT