Iran Earthquakes

AI エージェント向け

• **概要：**イランの地震を扱う非公式の MCP サーバー（モデルコンテキストプロトコル）です。データソース：USGS ComCat（source="usgs"、デフォルト）、SeismicPortal 経由の EMSC（source="emsc"）、Iranian Seismological Center（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を使います。
• **使用する場面：**ユーザーがイランの最近または過去の地震、最大規模の地震、州や都市付近の地震、ある期間の活動状況について尋ねた場合に使用します。
• **使用しない場面：**公式の警報や注意報が必要な場合（警報サービスではありません。Iranian Seismological Centerを参照してください）、またはイランおよびその隣国以外の地震について尋ねられた場合には使用しないでください。
• 単位：time_utc（UTC）とtime_tehran（UTC+03:30、夏時間なし）。検索日は UTC です。depth_kmの単位はキロメートルです。mag_type（mb、ml、mw など）はマグニチュードの種類を示します。
• **応答：**1回の呼び出しにつき最大50件（limitは1～50）で、最大時は約12 KB、15 KB 未満です。
• 機械可読：server.jsonおよびiran-mcp カタログ。

理由

地震フィードは地震学者向けに作られており、サーバーごとに形式が異なり、ID 形式もまちまちで、タイムスタンプは UTC、州フィールドもありません。 「今週、ケルマーン付近でマグニチュード 4.5 を超える地震はありましたか？　また、今月のイランで最も強かった地震は何ですか？」と尋ねるには、 地図やクエリフォームで検索し、時刻を手作業で変換する必要があります。iran-quake-mcp を使えば、エージェントは数回の呼び出しで回答し、 テヘラン時間と深さ（キロメートル単位）を含む短い要約を返します。

あなた： 過去 30 日間にイランで強い地震はありましたか？

エージェント： eq_significant(days=30, min_magnitude=5.0) を呼び出し → 最大の地震について eq_detail(...) を呼び出します

地震をマグニチュード、場所、深さ、テヘラン時間とともに大きい順に一覧表示し、最も大きな地震のレビュー状況と有感報告も追加します。

すべての応答は 15 KB 未満（最大でも約 12 KB）に収まるため、エージェントのコンテキストを圧迫しません。

できること

• イランの最新の地震を、最小マグニチュードと過去何時間分かで絞り込み、新しい順に表示
• UTC の日付範囲、マグニチュード範囲、境界ボックス、場所のテキストで検索し、時刻順またはマグニチュード順に並べ替え
• 過去 N 日間で最も強い地震を大きい順に表示
• ID を指定して地震の詳細を表示：USGS ではレビュー状況、有感・揺れ、津波フラグ、品質を、EMSC では機関と更新時刻を、IRSC では最寄りの町を表示
• 期間ごとの統計：マグニチュード帯別の件数、主な場所、最も強い地震
• 1 つのサーバーで3 つの情報源を利用：USGS、EMSC、Iranian Seismological Center
• 設計上読み取り専用：書き込みも購読も行いません

プロンプトの例：

• 「過去 48 時間にイランで発生したマグニチュード 4 以上の地震を表示してください。」
• 「過去 1 年間で最も強かった地震を 10 件教えてください。」
• 「今月、ケルマーン付近で地震はありましたか？」
• 「過去 30 日間のイランの地震統計を教えてください。」
• 「Iranian Seismological Center のフィードにある最新の地震の詳細を、州名付きで教えてください。」
• آخرین زلزله‌های ایران در ۲۴ ساعت گذشته کدام‌اند؟
• قوی‌ترین زلزله‌های ماه اخیر در ایران را با عمق و ساعت تهران بده.
• آیا در هفته گذشته در هرمزگان زلزله بالای ۴ ریشتر آمده؟

クイックスタート

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に制限し、通信先はこの3つのホストのみに限定しています。読み取り専用です。

知っておくとよいこと

• 時刻： time_utcはUTC、time_tehranはUTC+03:30です（2022年以降、夏時間はありません）。検索の日付はUTCです。深度は正の値で、depth_kmで表されます。
• マグニチュード： タイプはmag_type（mb、ml、mwなど）に記載されます。タイプやデータソースが異なる値は、厳密には比較できません。
• データソースは個別に扱われます： 結果は統合も重複排除もされず、IDも異なります。eq_detailに渡せるのはイベントIDのみで、形式からデータソースを判別します。EMSCは20261014_0000009、IRSCは213549などの数字のみ（最新の約20件で見つかった場合のみ）、それ以外はUSGSです。
• デフォルトではイラン国内のみ： イベントは、おおまかなイランの境界（陸上の国境では約0.3度の範囲に加え、ペルシャ湾、オマーン湾、カスピ海のイラン側海域）内で発生し、場所のテキストにイラン、ペルシャ湾、オマーン湾、またはカスピ海の記載がある必要があります。国境のすぐ外で発生したイベントは除外されます。iran_only=falseを指定すると、北緯24～40度、東経43.5～64度のボックス内のすべてのイベントが返されます。
• 場所： 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になります。データは非商用かつ人道目的での利用が許諾されており、Iranian Seismological Center (University of Tehran)を出典として明記する必要があります。
• 返信サイズ： limitの上限は50です。取得した生データが3000行いっぱいに返された場合、eq_statsはtruncatedを設定します。
• 遅延と改訂： フィードには小規模なイベントが遅れて掲載され、値が後で改訂されることがあります。USGSへのキャッシュのないクエリには約10秒かかる場合があります。
• 対応していない機能： アラート、プッシュ通知、早期警報、揺れのマップ、被害の推定には対応していません。
• ネットワーク： フィードに直接接続できない場合は、IRAN_QUAKE_MCP_PROXYを設定してください。システムのプロキシ変数は意図的に無視されます。

FAQ

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 にあります。各ツールは型指定された非同期関数で、エージェントがいつ使うべきかを説明する docstring が付いています。課題や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグを push してください。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