water-conditions

按湖泊、河流、海洋、海湾或海滩的名称或经纬度坐标，获取实时水温和潮汐预测数据。数据实时来自 NOAA CO-OPS、USGS 和 seatemperature.info；输入坐标时会自动匹配最近的站点。覆盖北美地区及主要国际水域中的 8,000 多个具名地点，并支持将字符串地理编码为坐标以作备用。

mcp-name: io.github.aybeeare/water-conditions

路线图：扩展国家级传感器网络

目前的准确性层级为：USGS/NOAA（真实政府传感器，可提供对应站点的实测数据）> seatemperature.info（最佳估算聚合器，没有已知的专用传感器网络，通过地理编码用于其他所有地点）。计划是按国家逐步扩展第一层——以与 USGS/NOAA 相同的方式接入真实传感器网络——而不是长期依赖聚合器作为备用方案。目标是打造真正的“超级 API”，融合国家级传感器网络，正如本项目目前融合 USGS 与 NOAA 一样。

已确认且可以接入（免费、开源、无需 API 密钥）：

• 英国环境署 — 最优先的下一候选。水文 API（河流流量/水位/地下水，约 8,000 个站点，15 分钟分辨率）+ 洪水监测 API（河流/潮汐水位）——开放性和易用性与 USGS/NOAA 相当，采用英国开放政府许可证。
• 法国 SHOM/REFMAR — 约 100 个实时潮位计，采用 Licence Etalab 2.0。

已调研，接入较复杂：

• Copernicus Marine Service（欧盟/全球海表温度，卫星 + 原位数据）——免费且权威，但批量数据产品属于科学级数据（通过 Python 工具箱提供 NetCDF），而非简单的逐站点 JSON。它提供 REST“原位数据仪表板”，值得进一步了解。

已调研，近期接入路径尚不明确：

• 东亚（日本 JMA/JODC、韩国 KMA）——两地都有相关机构，但初步搜索发现，数据访问似乎比英国的情况更分散或受许可限制（日本的潮汐数据似乎需要通过授权分销商获取，而不是通过开放、简洁的接口）。承诺接入前需要深入调研——近期不会优先考虑。

北美（USGS/NOAA）+ 欧洲（英国 EA、法国 SHOM）足以覆盖当前的优先区域。其他地区仍将使用地理编码 + seatemperature.info 备用方案，除非某个地区的传感器网络确实值得投入接入工作。

查看 MCP 活动（仅限所有者）

每次调用 get_water_conditions 工具都会记录在数据库中。要从运行中的服务获取摘要：

1. 一次性设置 — 在 Railway 中设置 ACTIVITY_API_KEY（已完成）。请妥善保存该值。

2. 运行活动脚本 — 在此项目文件夹中打开终端，并运行以下两条命令：

$env:ACTIVITY_API_KEY="your-secret-here"
python scripts/activity.py

此脚本会输出调用总数、查询过的地点数、成功率，以及最近 50 次单独调用的时间戳和温度。

每个终端会话中只需运行一次 $env: 那一行。之后可以根据需要反复运行 python scripts/activity.py。