water-conditions

名前または緯度・経度の座標を指定して、あらゆる湖、川、海、湾、ビーチのリアルタイム水温および潮汐予測データを取得します。データは NOAA CO-OPS、USGS、seatemperature.info からリアルタイムで取得し、座標入力の場合は最寄りの観測所を自動的に照合します。北米および主要な国際水域にわたる 8,000 か所以上の名称付き地点をカバーし、フォールバック用に地名から座標へのジオコーディングも行います。

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

ロードマップ：全国センサーネットワークの拡大

現在の精度の優先順位は、USGS／NOAA（実際の政府センサーで、該当観測所の実測値）＞ seatemperature.info（専用センサーネットワークは確認されていない、最善推定のアグリゲーターで、ジオコーディングを介して他のすべての地点に使用）です。長期的には、アグリゲーターのフォールバックに頼るのではなく、国ごとに、USGS／NOAA と同じ方式で接続した実際のセンサーネットワークを第 1 層に追加する計画です。目標は、このプロジェクトがすでに USGS と NOAA を組み合わせているように、各国のセンサーネットワークを統合する真の「スーパー API」です。

統合が確認され、準備が整っているもの（無料、オープン、API キー不要）：

• UK Environment Agency — 次の有力候補です。Hydrology API（河川の流量／水位／地下水、約 8,000 観測所、15 分間隔）と Flood Monitoring API（河川／潮位）は、USGS／NOAA と同様にオープンでシンプルです。Open Government Licence が適用されます。
• France SHOM/REFMAR — リアルタイム潮位計が約 100 基あります。Licence Etalab 2.0 が適用されます。

調査済み、統合はより複雑：

• Copernicus Marine Service（EU／世界の海面水温、衛星＋現場観測） — 無料で信頼性も高いですが、バルクデータ製品は、シンプルな観測所単位の JSON ではなく、科学用途向け（Python ツールボックス経由の NetCDF）です。詳しく調べる価値のある REST「In Situ Dashboard」があります。

調査済み、近い将来の道筋は不明：

• 東アジア（Japan JMA/JODC、Korea KMA） — どちらにも関連機関はありますが、初期調査では、アクセスが英国のケースよりも分散しており、ライセンスも複雑なようです（日本の潮汐データは、明確なオープンエンドポイントではなく、認可された販売代理店経由で提供されているようです）。導入を決める前に、実際の調査が必要です。近い将来の対象ではありません。

北米（USGS／NOAA）と欧州（UK EA、France SHOM）を組み合わせれば、現在の優先地域を十分にカバーできます。それ以外の地域については、特定地域のセンサーネットワークが統合に見合うと判断されない限り、ジオコーディングと seatemperature.info のフォールバックを引き続き使用します。

MCP アクティビティの確認（所有者のみ）

get_water_conditions ツールへのすべての呼び出しは、データベースに記録されます。ライブサーバーから概要を取得するには：

1. 初回のみの設定 — Railway で ACTIVITY_API_KEY を設定します（設定済みです）。値は安全な場所に控えておいてください。

2. アクティビティスクリプトを実行 — このプロジェクトフォルダーでターミナルを開き、次の 2 つのコマンドを実行します。

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

合計呼び出し数、照会された地点のユニーク数、成功率、およびタイムスタンプと水温を含む直近 50 件の個別の呼び出しが表示されます。

$env: の行は、ターミナルセッションごとに 1 回だけ実行すれば十分です。その後は、必要な回数だけ python scripts/activity.py を再実行できます。