Claude MCP Server for USGS Quakes API

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Serves as the runtime environment for the MCP server, enabling it to process requests and communicate with the USGS Quakes API

USGS-地震-MCP

USGS Quakes API 用の Claude MCP サーバー

Claude Desktop内でUSGS Quakes APIへのアクセスを提供するための MCP サーバー実装。

概要

このモデル コンテキスト プロトコル (MCP) サーバーにより、AI アシスタントとアプリケーションは次のことが可能になります。

  • さまざまな検索パラメータから地震データを取得する
  • 特定の地震に関する詳細情報を取得する

ユーザーは自然言語を使用してクエリを実行できます。

サンプル出力

Q: 過去20年間にフロリダで発生したマグニチュード2以上の地震を調べてください

**A:**過去 20 年間にフロリダで発生したマグニチュード 2.0 を超える地震の検索をお手伝いします。

usgs-quakes (local) の find-earthquakes の結果を表示

{ "endTime": "2024-12-28T23:59:59", "startTime": "2004-12-28T00:00:00", "maxLatitude": 31.000888, "minLatitude": 24.396308, "maxLongitude": -80.031362, "minLongitude": -87.634896, "minmagnitude": 2 }

USGS の地震データによると、過去 20 年間にフロリダ州またはその近辺で 3 つの注目すべき地震が発生しています。

  1. 2006年9月10日、メキシコ湾でマグニチュード5.9の地震が発生しました。発生場所:沖合、座標:北緯26.319度、西経86.606度。深さ:14km。この地震は、この時期にこの地域で発生した最大の地震でした。広範囲で感じられ、5,763人が地震を感じたと報告しています。
  2. 2019年3月6日、フロリダ州ジェイ近郊でマグニチュード2.8の地震が発生しました。発生場所:北緯30.9718度、西経87.1719度。深さ:5km。49人がこの地震を感じたと報告しています。
  3. 2019年3月24日、フロリダ州センチュリー近郊でマグニチュード2.7の地震が発生しました。発生場所:北緯30.9622度、西経87.2384度。深さ:5km。4人がこの地震を感じたと報告しています。

フロリダ州は、アメリカ合衆国の地震活動が活発な地域に比べて地震の発生頻度が比較的少ないことは注目に値します。2019年の2つの地震はフロリダ州西部で発生しましたが、2006年のより大きな地震はメキシコ湾沖で発生しました。

Q: ジェイフロリダ地震の詳細を教えてください

**A:**フロリダ州ジェイ近郊で発生したマグニチュード2.8の地震についての詳しい情報を入手します。

usgs-quakes (local) の find-earthquake-details の結果を表示

{ "eventid": "us1000jbw4" }

フロリダ州ジェイ地震の主な詳細は次のとおりです。日時:2019年3月7日、午前4時45分52秒(UTC)場所:フロリダ州ジェイの北西2キロメートル(1.2マイル)座標:北緯30.9718度、西経87.1719度深さ:5キロメートル(3.1マイル)マグニチュード:2.8 mb_lg(実体波マグニチュード)

追加の詳細:

  • 49人が地震を感じたと報告
  • コミュニティインターネット強度マップ(CIIM)は、最大強度2.7を示した。
  • 津波は発生しなかった
  • この地震はUSGSの科学者によって調査され、確認された。
  • この位置の水平誤差は約6.2 kmでした
  • マグニチュードの計算には11の地震観測所のデータが使用された。
  • この地震はニューメキシコ地震観測網(NM)でも観測され、わずかに異なるマグニチュード2.63と算出された。

技術測定:

  • 方位角ギャップ: 243 度 (地震観測所による中程度のカバー範囲を示します)
  • RMS誤差: 0.59 (位置推定の品質が妥当であることを示します)
  • 最寄り駅までの最小距離: 0.222度
  • 大きさの標準誤差: 0.154

これは比較的小規模な地震でしたが、地震活動が稀なフロリダ州にとっては注目すべき出来事でした。49人が揺れを感じたという事実は、近隣住民にとって大きな衝撃であったことを示唆していますが、この規模の地震では大きな被害は予想されません。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の USGS 地震データを自動的にインストールするには:

npx -y @smithery/cli install @blake365/usgs-quakes-mcp --client claude

手動インストール

Node.js と MCP プロトコルに精通していない場合、これをインストールするのは難しいかもしれません。

  1. Node.jsをインストールする
  2. このリポジトリをローカルマシンのフォルダにクローンします
  3. サーバーはすでに構築されているため、ビルド手順をスキップできます。

追加の手順

サーバーに変更を加えたい場合はsrc/index.tsファイルを編集します。

  • npm install実行して依存関係をインストールします
  • npm run buildを実行してサーバーをビルドします
  • 変更を加えたら、Claude Desktop を終了して再起動します。

Claude Desktopとの接続

  1. Claude Desktop の構成を次の場所で開きます:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. サーバー構成を追加します。
{ "mcpServers": { "usgs-quakes": { "command": "node", "args": [ "/Full/Route/to/Folder/usgs-quakes/build/index.js" ] } } }
  1. Claude Desktop を閉じて再起動します

再起動すると、テキストボックスの右下に小さなハンマーアイコンが表示されます。アイコンにマウスを合わせると、利用可能なMCPツールの数が表示されます。

トラブルシューティング

サーバーの実行中にエラーが発生した場合は、 nodeコマンドのフルパスを指定する必要があるかもしれません。例えば、macOSの場合: /usr/local/bin/node

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude Desktop 内で USGS Quakes API へのアクセスを提供し、ユーザーが自然言語クエリを通じて地震データと詳細を取得できるようにします。

  1. Overview
    1. Sample Output
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
        3. Extra Steps
      2. Connecting with Claude Desktop
        1. Troubleshooting
          ID: vhd9mjkxya