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	当前河流水位（测站水位，英尺）、流量（排放量，ft3/s）和有测量记录时的水温、测量时间、NWS 洪水水位、当前洪水等级、距离洪水水位的剩余英尺数和历史最高水位。若读数已超过 48 小时，则会标记。
get_river_history	过去 2 到 366 天的日均流量或水位，以及首值、末值、最低值、最高值、均值和变化。
get_flood_forecast	某个水文站当前的 NWS 河流预报：预报序列、预报最高水位及其洪水等级、最新观测值、洪水水位和历史最高水位。

每条结果都包含结构化 JSON、一段摘要、as_of、source（USGS 或 NWS 水文站页面）和 more（lakelevelnow.com 上的页面）。

模型不知道的信息

• 今天的河流水位。水文站每 5 到 60 分钟报告一次，而河流水位一天之内可能上涨 10 英尺。模型的训练数据可能已过时数月。
• 现在河流是否接近洪水水位，依据的是 NWS 针对该水文站设置的行动、轻度、中度和重大洪水水位。
• 最新的 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 或更高版本。

示例提示词

• “密苏里州圣路易斯的密西西比河现在水位是多少？”
• “波托马克河 Little Falls 段接近洪水水位了吗？”
• “科罗拉多河奥斯汀段的流量是多少？过去 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。
• 托管服务会在边缘节点缓存读数几分钟、站点详情一天，因此重复调用不会访问 USGS 或 NOAA。

限制

• USGS 实时数据为暂定数据，之后可能会修订。工具会对此作出说明。
• 只有作为 NWS 预报点的测站才有洪水水位和预报。其他测站仍会返回 USGS 读数。
• NWS 水位和 USGS 测站水位通常使用相同的测站基准面，但出于安全考虑，在依赖阈值比较之前，请查看 NWS 测站页面。判断洪水情况时，请遵循当地 NWS 警报。
• USGS API 会对未使用密钥的调用方进行速率限制。如果 API 返回 429 或服务中断，工具会返回明确的错误，而不会提供过时或缓存的数值。
• 湖泊和水库由 lake-level-mcp 提供支持。

更多信息

Lake Mead、Lake Powell、Lake Travis 等湖泊和水库的实时水位见 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