USGS Water Services MCP Server

io.github.mansurjisan由 GitHub 帳號 mansurjisan 發布v0.1.0更新於 Oct 24, 2026

USGS Water Services streamflow, flood stages, and peak events via waterservices.usgs.gov

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

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理透過 USGS Water Services 查詢河川流量、NWS/NWPS 洪水狀態與洪峰事件。

可以做什麼
透過 waterservices.usgs.gov 取得 USGS 河川與測站的流量資料,登錄描述與 README 伺服器表列出流量、NWS/NWPS 洪水狀態與洪峰事件。README 未列出此伺服器個別的工具,因此具體操作未在此說明。它是可獨立安裝的海洋與海岸資料伺服器系列之一,README 展示了它與潮位、暴潮和衛星伺服器組合的跨伺服器查詢。回應遵循共用慣例:預設 markdown,視工具可為 json、geojson 或 image。
適用情境
適合讓助理取得 USGS 河川與溪流測站讀數、查看洪水狀態或查詢歷史洪峰事件,尤其在同一設定中與其他海洋和海岸資料伺服器一起使用時。
執行需求
以 stdio 本機程序執行,從 PyPI 以 usgs-mcp 安裝,通常用 uvx 啟動(需要 Python 工具鏈)。未宣告 API 金鑰或環境變數;README 稱這些資料伺服器使用免費公開資料集。需要連線至 USGS 服務的網路。
安裝前請注意
README 稱資料伺服器為唯讀,僅取得資料而不修改任何內容。查詢會送往公開的 USGS 端點,所要求的位置與參數會傳送給該第三方。資料為公開參考資料,用於安全或洪水決策前應自行核實。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 USGS Water Services MCP Server,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

其他 MCP 客戶端

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

README

OceanMCP

A monorepo of independently installable MCP servers for ocean and coastal data workflows.

[PyPI] [CI] [MCP Registry] [License: MIT]

Servers

ServerPyPIDescription
coops-mcp[PyPI]NOAA CO-OPS tides, water levels, currents, meteorological data
erddap-mcp[PyPI]Universal ERDDAP data access across 80+ public servers
nhc-mcp[PyPI]NHC storm tracks, advisories, HURDAT2 best track data
recon-mcp[PyPI]Hurricane reconnaissance data (HDOB, Vortex Data Messages, ATCF fixes)
stofs-mcp[PyPI]NOAA STOFS storm surge forecasts and observation validation
ofs-mcp[PyPI]NOAA OFS regional ocean model forecasts (water level, temperature, salinity)
rtofs-mcp[PyPI]NOAA RTOFS global ocean forecasts (SST, salinity, currents, SSH) via HYCOM THREDDS
ww3-mcp[PyPI]GFS-Wave (WAVEWATCH III) forecasts and NDBC buoy wave observations
ndbc-mcp[PyPI]NOAA NDBC buoy observations — waves, SST, wind, pressure (1,300+ stations)
winds-mcp[PyPI]NWS surface wind observations from ASOS / AWOS stations
usgs-mcp[PyPI]USGS Water Services — streamflow, NWS/NWPS flood status, peak events
goes-mcp[PyPI]NOAA GOES-18/19 satellite imagery — visible, infrared, water vapor
vdatum-mcp[PyPI]Vertical datum conversion — NAVD88, MLLW, MHHW, LMSL, xGEOID20b and more
adcirc-mcp[PyPI]ADCIRC model setup debugging, parameter lookup, config validation
schism-mcp[PyPI]SCHISM model setup debugging, parameter lookup, config validation

No API keys required for the data servers — all servers above use free, publicly available datasets. The exceptions are hpc-system-mcp and ufs-runner-mcp (below), which require actual NOAA RDHPCS cluster access and, in ufs-runner-mcp's case, submit real Slurm jobs.

Additional servers live in this repo but are not yet published to PyPI (install from source): hpc-system-mcp and ufs-runner-mcp (NOAA RDHPCS / UFS-Coastal HPC workflows — require cluster access), and alert-mcp (CO-OPS threshold alerting).

There is also a 19th server in this repo, nos-workflow-mcp, which is experimental and still a work in progress (its full implementation lives on an unmerged branch — main carries only a minimal subset). It's intentionally left out of the table above and not yet ready for general use.

Quick Start

Install from PyPI

bash
# uvx (recommended) — runs without permanent install, like npx for Pythonuvx coops-mcp
# pip — install into current environmentpip install coops-mcp
# pipx — install in isolated environment with CLI entry pointpipx install coops-mcp

Replace coops-mcp with any published server: erddap-mcp, nhc-mcp, recon-mcp, stofs-mcp, ofs-mcp, rtofs-mcp, ww3-mcp, ndbc-mcp, winds-mcp, usgs-mcp, goes-mcp, vdatum-mcp, adcirc-mcp, schism-mcp.

Install from source

bash
git clone https://github.com/oceanmodeling/ocean-mcp.gitcd ocean-mcp/servers/coops-mcp  # or any other server directory under servers/uv sync

Configure your MCP client

Add to your MCP settings (e.g., project .mcp.json):

Using PyPI packages (recommended):

json
{  "mcpServers": {    "coops": {      "command": "uvx",      "args": ["coops-mcp"]    },    "erddap": {      "command": "uvx",      "args": ["erddap-mcp"]    },    "nhc": {      "command": "uvx",      "args": ["nhc-mcp"]    },    "recon": {      "command": "uvx",      "args": ["recon-mcp"]    },    "stofs": {      "command": "uvx",      "args": ["stofs-mcp"]    },    "ofs": {      "command": "uvx",      "args": ["ofs-mcp"]    },    "rtofs": {      "command": "uvx",      "args": ["rtofs-mcp"]    },    "ww3": {      "command": "uvx",      "args": ["ww3-mcp"]    }  }}
Using local source checkout
json
{  "mcpServers": {    "coops": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/coops-mcp", "python", "-m", "coops_mcp"]    },    "erddap": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/erddap-mcp", "python", "-m", "erddap_mcp"]    },    "nhc": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/nhc-mcp", "python", "-m", "nhc_mcp"]    },    "recon": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/recon-mcp", "python", "-m", "recon_mcp"]    },    "stofs": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/stofs-mcp", "python", "-m", "stofs_mcp"]    },    "ofs": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/ofs-mcp", "python", "-m", "ofs_mcp"]    },    "rtofs": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/rtofs-mcp", "python", "-m", "rtofs_mcp"]    },    "ww3": {      "command": "uv",      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/ww3-mcp", "python", "-m", "ww3_mcp"]    }  }}

Example Queries

With servers configured, you can ask your AI assistant naturally:

CO-OPS queries:

  • "Get current water levels at The Battery, NY"
  • "Find tide stations near Miami Beach"
  • "What are the flood statistics for Charleston, SC?"
  • "Show me the sea level trend at San Francisco"

ERDDAP queries:

  • "Search for sea surface temperature datasets on CoastWatch"
  • "Get chlorophyll data off the California coast for January 2024"
  • "What ERDDAP servers cover the US East Coast?"
  • "List all glider datasets on IOOS Gliders ERDDAP"

NHC queries:

  • "Are there any active tropical cyclones right now?"
  • "Show me Hurricane Katrina's track"
  • "Search for Category 5 hurricanes in the Atlantic"
  • "What is the forecast track for the active storm?"

Recon queries:

  • "List HDOB reconnaissance flights for the 2024 Atlantic season"
  • "Get HDOB flight-level observations from October 7, 2024"
  • "Show me the Vortex Data Messages for Hurricane Milton"
  • "Get ATCF aircraft fix data for storm AL14 2024"

STOFS queries:

  • "Get the STOFS water level forecast for The Battery, NY"
  • "Compare STOFS forecast vs observations at Boston for the past 24 hours"
  • "What are the top stations with highest predicted water levels?"
  • "Find STOFS stations within 50 km of New Orleans"

OFS queries:

  • "What OFS models cover the Chesapeake Bay?"
  • "Get the water level forecast at lat 38.98, lon -76.48 from CBOFS"
  • "Compare CBOFS water level with CO-OPS observations at station 8571892"
  • "List available NGOFS2 forecast cycles for today"

RTOFS queries:

  • "Get the RTOFS sea surface temperature forecast at 40°N, 74°W"
  • "Show me a temperature depth profile in the Gulf Stream"
  • "What RTOFS datasets are currently available on HYCOM THREDDS?"
  • "Get a vertical transect of salinity from Miami to Bermuda"
  • "Show the SST area forecast for the Gulf of Mexico"

WW3 queries:

  • "What GFS-Wave model grids are available?"
  • "Find NDBC buoys near Cape Hatteras"
  • "Get the latest wave observations from buoy 41025"
  • "Show me the GFS-Wave forecast at 35°N, 75°W for the next 48 hours"
  • "Compare the wave forecast against buoy 41025 observations"

Cross-server queries:

  • "Find CO-OPS stations near this ERDDAP buoy location"
  • "Compare tide station data with nearby ERDDAP satellite SST"
  • "Is there an active hurricane threatening the Gulf Coast? If so, show me the STOFS surge forecast for New Orleans"
  • "Get the CBOFS water level forecast at Chesapeake Bay and compare it with the CO-OPS tide prediction for the same station"
  • "Show me sea surface temperature from ERDDAP near The Battery and the current water level from CO-OPS"
  • "Which NHC storms have hit the Gulf Coast historically? Show the CO-OPS flood statistics for impacted stations"
  • "Get the STOFS gridded forecast and the OFS water level forecast at the same location and compare them"

Architecture

Each server is fully self-contained with its own pyproject.toml, dependencies, and tests. See docs/architecture.md for details on shared conventions.

Shared patterns across servers:

  • FastMCP for MCP server framework
  • httpx for async HTTP clients
  • Pydantic models, with Literal[...] types for constrained parameters
  • Read-only tools by default — the data-fetching servers only fetch, never modify, anything. ufs-runner-mcp (submits/cancels Slurm jobs) and alert-mcp (creates/pauses/deletes in-memory alert state) are the two exceptions, each with a small number of tools marked readOnlyHint=False
  • response_format output as markdown (default), json, geojson, or image, depending on the tool
  • Actionable error messages with suggestions

See CONVENTIONS.md for the full response/behavior contract (output caps, retrieved_at, error format, HTTP retries, dependency bounds).

Reproducible verification and evaluation packages for the server releases are in verification/.

Citation

If you use this project in your research or work, please cite:

bibtex
@software{jisan2025oceanmcp,  author    = {Jisan, Mansur Ali},  title     = {Ocean MCP: Real-Time Marine Data, MCP-Native},  year      = {2025},  url       = {https://github.com/oceanmodeling/ocean-mcp},  note      = {MCP servers for NOAA CO-OPS, ERDDAP, NHC, Recon, STOFS, OFS, RTOFS, WW3, NDBC, USGS, winds, GOES, ADCIRC, and SCHISM data}}

License

Licensed under the MIT License. You may use, modify, and distribute this software under the MIT terms. See LICENSE for details.

來源:README.md,提交 575cd21

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分