River Level MCP

river-level-mcp

AI アシスタント向けの米国の河川水位情報：USGS の水位観測所から取得する河川水位、流量、水温に加え、NWS の洪水水位と河川予報を提供します。

これは Model Context Protocol（MCP）サーバーです。呼び出し時に USGS Water Data API と NOAA National Water Prediction Service を参照します。API キーは不要です。

ツール

ツール	返される情報
find_river_gauges	河川名と地名、州、または緯度と経度を指定して、稼働中の USGS 河川・水流観測所を検索します。各観測所の最新の水位と流量も返します。稼働中の観測所が先に表示されます。
get_river_level	現在の河川水位（ゲージ高、ft）、流量（放流量、ft3/s）、測定されている場合は水温、測定時刻、NWS の洪水水位、現在の洪水カテゴリ、洪水水位までの残りのフィート数、過去最高水位を返します。48 時間以上前の測定値にはフラグを付けます。
get_river_history	2～366 日分の日平均流量または水位と、最初・最後・最低・最高・平均の値、および変化を返します。
get_flood_forecast	観測所の現在の NWS 河川予報を返します。予報時系列、予報最高水位とその洪水カテゴリ、最新の観測値、洪水水位、過去最高水位が含まれます。

すべての結果には、構造化 JSON、1 段落の要約、as_of、source（USGS または NWS の観測所ページ）、more（lakelevelnow.com のページ）が含まれます。

モデルが知らない情報

• 今日の河川水位。観測所は 5～60 分ごとに報告し、河川の水位は 1 日で 10 フィート上昇することがあります。モデルの学習データは数か月前のものです。
• その観測所の NWS の警戒、軽度、中程度、重大な洪水水位を使って、現在、河川が洪水水位に近いかどうかを判断します。
• 1 日に数回更新される、最新の NWS 河川予報とその予報最高水位。
• 新しい USGS Water Data API。従来の waterservices.usgs.gov サービスは 2027 年 2 月 22 日に終了するため、これを呼び出すコードは動作しなくなります。このサーバーはすでに api.waterdata.usgs.gov を使用しています。

インストール

ホスト型（Claude.ai カスタムコネクター、ChatGPT 開発者モード）

この URL を貼り付けてください。トークンも登録も不要です。

https://river-level-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http river-level https://river-level-mcp.lipmichal.workers.dev/mcp

または、stdio を使ってローカルで実行します。

claude mcp add river-level -- npx -y github:theluckystrike/river-level-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "river-level": { "command": "npx", "args": ["-y", "github:theluckystrike/river-level-mcp"] }
  }
}

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "river-level": { "url": "https://river-level-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "river-level": { "type": "http", "url": "https://river-level-mcp.lipmichal.workers.dev/mcp" }
  }
}

ローカルの stdio 版には Node 20 以降が必要です。

プロンプトの例

• 「今、セントルイスのミシシッピ川の水位はどれくらいですか？」
• 「リトルフォールズ付近のポトマック川は洪水水位に近いですか？」
• 「オースティンのコロラド川の流量はどれくらいで、過去 90 日間でどう変化しましたか？」
• 「EADM7 ではいつ河川水位が最高になりますか？ 洪水水位に達しますか？」
• 「38.95, -77.13 から 10 マイル以内にある水流観測所はどこですか？」

データソース

取得日を含む全リストは DATA_SOURCES.md をご覧ください。

• 河川水位、流量、水温、日平均値、地点の詳細は USGS Water Data API（OGC API コレクション latest-continuous、daily、monitoring-locations）から取得します。
• 洪水水位、過去最高水位、河川予報は NOAA National Water Prediction Service API から取得します。
• ホスト型サーバーは測定値をエッジで数分間、地点の詳細を 1 日間キャッシュするため、繰り返し呼び出しても USGS や NOAA にはアクセスしません。

制限事項

• USGS のリアルタイムデータは暫定的なもので、改訂される場合があります。ツールでもその旨を示します。
• 洪水基準水位と予報があるのは、NWS の予報地点である観測所のみです。それ以外の観測所でも、USGS の観測値は返されます。
• NWS の水位基準と USGS の観測水位は、通常は同じ観測所基準面を使用していますが、安全のために閾値を比較する場合は、NWS の観測所ページを確認してください。洪水に関する判断では、地域の NWS 警報に従ってください。
• USGS API は、キーなしで利用する呼び出し元にレート制限を適用します。429 を返す場合や API がダウンしている場合、ツールは古い値や記憶された値ではなく、明確なエラーを返します。
• 湖と貯水池については、lake-level-mcp が対応しています。

詳細

ミード湖、パウエル湖、トラビス湖などの湖や貯水池のリアルタイム水位は、lakelevelnow.com で確認できます。

Zovo MCP コレクションの一部です：https://mcp.zovo.one

開発

npm install
npm test            # builds, then runs the fixture tests against saved USGS and NOAA payloads
node scripts/smoke-stdio.mjs   # live stdio check, one real call per tool
npx wrangler deploy            # Cloudflare Worker, Streamable HTTP at /mcp

ライセンス

MIT