Usgs Water Mcp

io.github.mrfentmen由 GitHub 帳號 mrfentmen 發布v1.0.5更新於 Nov 3, 2026

MCP server for USGS streamflow, gauge status, and water observations.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理查詢公開的 USGS 水文站資料：瞬時流量、日值、測站搜尋與測站中繼資料。

可以做什麼
  • 依參數代碼取得單一水文站的瞬時水文觀測，00060 為常用流量參數
  • 在經緯度邊界框內尋找啟用中的水文站，並限制回傳筆數
  • 讀取水文站的測站中繼資料：名稱、郡、集水區面積與座標
  • 依日期範圍取得水文站的日值資料
  • 查詢常用 USGS 參數代碼及其名稱與單位
適用情境
適合需要助理取得 USGS 流量與水文站資訊，用於流域研究、水文問題解答或快速查看河川水情的場合，不必離開對話，也不必處理 API 金鑰。
執行需求
以本機 Node.js 程序執行，從 npm 套件安裝並透過 stdio 啟動；不需要 API 金鑰、憑證或本機來源資料。需要能連線至 USGS Water Services 的網路，請求會在 20 秒後逾時。
安裝前請注意
USGS 資料可能為暫定資料，之後可能被修訂，不宜視為最終或權威結果。此伺服器為唯讀，不需要任何憑證；查詢會送往公開的 USGS Water Services 端點。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Usgs Water Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

usgs-water-mcp

Query public USGS water observations for stream gauges and watershed research. This is separate from earthquake data and focuses on streamflow and gauge discovery.

Tools

  • get_streamflow: instantaneous observations for a gauge and USGS parameter code. 00060 is the common discharge parameter.
  • find_gauges: find active stream gauges in a min longitude,min latitude,max longitude,max latitude bounding box, with a bounded result count.

The server uses USGS Water Services without an API key. Data can be provisional and may be revised by USGS. Requests time out after 20 seconds.

Run

bash
npm installnpm run buildnode dist/index.js

Read-only stdio MCP server. No credentials or local source data are required.

來源：README.md，提交 f1d2eaa

工具

5

get_streamflow

Get USGS instantaneous water observations for one gauge.

輸入參數endsite必填startparameter

find_gauges

Find active USGS stream gauges in a longitude,latitude bounding box.

輸入參數bbox必填limit

site_info

Site metadata for a USGS gauge: name, county, drainage area and coordinates.

輸入參數site必填

daily_values

Daily values for a USGS gauge over a date range.

輸入參數endsite必填startparameter

parameter_codes

Common USGS parameter codes with names and units.

無需輸入參數。

版本歷史

2
  1. v1.0.5最新Oct 29, 2026
  2. v1.0.0Sep 22, 2026

評分

已滿足適用檢查項的 80%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。