Usgs Water MCP

🚀 USGS Water MCP

このプロジェクトのMCPサーバーは、3つのAPIを通じて米国地質調査所（USGS）の水データに包括的にアクセスできるようにします。これにより、リアルタイムの水質測定、洪水の影響、および監視地点のメタデータなど、幅広い情報を取得できます。

🚀 クイックスタート

このMCPサーバーは、3つのAPIを通じてUSGSの水データにアクセスできます。サーバーはモジュール式に設計されており、個別のAPIハンドラーが単一のエントリポイントで統合されています。

✨ 主な機能

• USGS Water Services API - リアルタイムの水質測定データ（流量、水位、温度など）を提供します。
• Real-Time Flood Impacts API - 現在の洪水状況と基準点を提供します。
• OGC API - 監視地点のメタデータ、機関コード、および地質情報を提供します。

📦 インストール

pipを使用したインストール

pip install -e .

手動インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   pip install httpx mcp
   

💻 使用例

基本的な使用法

ポトマック川の流量データを取得する例です。

{
  "name": "USGS:01646500:00060:00000",
  "sourceInfo": {
    "siteName": "POTOMAC RIVER NEAR WASHINGTON, DC",
    "siteCode": [
      {
        "value": "01646500",
        "network": "NWIS",
        "agencyCode": "USGS"
      }
    ]
  },
  "variable": {
    "variableCode": [
      {
        "value": "00060",
        "network": "NWIS",
        "vocabulary": "NWIS:UnitValues",
        "variableName": "Streamflow, ft³/s",
        "variableDescription": "Discharge, cubic feet per second"
      }
    ]
  },
  "values": [
    {
      "value": [
        {
          "value": "6420",
          "qualifiers": ["A"],
          "dateTime": "2023-10-01T12:00:00.000"
        }
      ]
    }
  ]
}

📚 ドキュメント

プロジェクト構造

usgs-water-mcp/
├── main.py                  # 統一エントリポイント
├── water_data_api.py        # USGS Water Services APIツール
├── flood_impact_api.py      # Real-Time Flood Impacts APIツール
├── ogc_api.py              # OGC APIツール
├── current_water_levels.py  # 旧統合ファイル（非推奨）
├── Dockerfile              # Docker設定
├── pyproject.toml          # プロジェクトの依存関係
└── README.md               # このファイル

サービス

これらのツールを利用したクリーンなウェブインターフェイスを試したい場合は、https://aqua-node.onrender.com/landing にアクセスし、テストに協力してください！

利用可能なツール

水データツール

• fetch_usgs_data：USGSの監視局から瞬時の水データを取得します。
• get_flooding_reference_points：現在の洪水の基準点を取得します（30分ごとに更新）。
• get_reference_points：基準点のページ付きリストを取得します。
• get_reference_point_by_id：IDで特定の基準点を取得します。
• get_reference_points_by_state：特定の州の基準点を取得します。
• get_reference_point_by_nwis_id：USGSの水位計IDで基準点を取得します。
• get_reference_points_by_nws_id：国立気象サービスのIDで基準点を取得します。
• get_inactive_reference_points：非アクティブな基準点を取得します。
• get_states：州のリストを取得します。
• get_state_by_id：特定の州の情報を取得します。
• get_counties：郡のリストを取得します。
• get_counties_by_state：特定の州の郡を取得します。
• get_nws_usgs_crosswalk：国立気象サービスとUSGSのクロスウォークデータを取得します。

OGC APIツール

• get_monitoring_locations：広範なフィルタリングオプションで監視地点を取得します。
• get_monitoring_location_by_id：IDで特定の監視地点を取得します。
• get_agency_codes：機関識別コードを取得します。
• get_altitude_datums：垂直基準面の情報を取得します（推奨：NAVD88）。
• get_aquifer_codes：帯水層識別情報を取得します。
• get_aquifer_types：帯水層のタイプ情報（限定帯水層と非限定帯水層）を取得します。
• get_coordinate_accuracy_codes：緯度経度値の座標精度コードを取得します。

🔧 技術詳細

サーバーはモジュール式に設計されており、個別のAPIハンドラーが単一のエントリポイントで統合されています。これにより、保守性と拡張性が向上しています。

📄 ライセンス

原文書にライセンス情報はありません。

トラブルシューティング

一般的な問題

1. API接続エラー：インターネット接続がアクティブで、USGS APIにアクセス可能であることを確認してください。
2. 無効なサイト番号：USGS Water Data for the Nationウェブサイトを使用して、サイト番号が存在することを確認してください。
3. データが利用できない：一部のサイトでは、要求された期間またはパラメーターに対応するデータが存在しない場合があります。
4. レート制限：USGS APIには使用制限があります。短時間に大量のリクエストを行わないでください。

サイト番号の検索

USGS Water Data for the Nationウェブサイトを使用して、関心のある地域の監視局のサイト番号を検索できます。