floodwise

---

LLM に「SW1A 1AA の洪水リスクは？」と尋ねると、自信満々に答えますが、実際には知り得ません。郵便番号ごとの洪水リスクは、モデルの重みに含まれるデータではなく、政府のデータセットにある、個別に整備されたデータだからです。floodwise は、環境庁の公式データ 「洪水リスク：郵便番号検索ツール」 から郵便番号を検索し、実際の長期リスク区分を返します。見つからない場合は、推測する代わりに、正直に 「見つかりません」 と返します。

⚠️ まずお読みください — floodwise ができること、できないこと

• 対象はイングランドのみです。 データはイングランドを管轄する環境庁のものです。ウェールズ（Natural Resources Wales）、スコットランド（SEPA）、北アイルランド（DfI）は対象外です。有効なウェールズまたはスコットランドの郵便番号を入力した場合も、推測せずに 「見つかりません」 と返します。
• 地域単位であり、物件単位ではありません。 リスクは郵便番号の住所がある周辺地域のものであり、特定の建物のものではありません。環境庁は、このデータは 「一般に、物件単位の評価には適していません」 としています。
• 長期リスクであり、リアルタイムの警報ではありません。 長期的な年間洪水発生確率を示すものであり、現在洪水が発生しているか、または洪水が予測されているかを示すものではありません。保険、引受査定、測量、専門家による助言に代わるものではありません。

Claude に追加する

floodwise はローカルで stdio 経由で動作します（キーもログインも不要です）。npm で公開されたら、クライアントの設定で mcpServers の下に追加してください。

{ "command": "npx", "args": ["-y", "floodwise"] }

ライブラリとして使う

npm i floodwise

import { floodRiskByPostcode, validatePostcode } from "floodwise";

floodRiskByPostcode("SW1A 1AA");
// {
//   postcode: "SW1A 1AA", found: true, headlineRisk: "Very Low",
//   addressesAtRisk: { high: 0, medium: 0, low: 0 }, groundwater: "Unlikely",
//   coverage: "England", dataset: "ea-official", ...
// }

floodRiskByPostcode("EH1 1AA").found;   // false — valid postcode, but Scotland (out of EA coverage), no guess
validatePostcode("ec1a1bb");            // { valid: true, postcode: "EC1A 1BB", outcode: "EC1A", incode: "1BB" }

郵便番号は、スペースの有無や大文字・小文字を問わず受け付けます。形式が正しい郵便番号が読み込み済みのイングランドのデータセットに含まれていない場合は、明確な注記とともに found: false を返します。リスクレベルを捏造することはありません。

ツール — 2 種類

ツール	回答する内容
flood_risk_by_postcode	イングランドの郵便番号に対する環境庁の長期洪水リスク区分（高／中／低／非常に低）、各区分の住所数、および地下水に関する表示
validate_postcode	形式が正しい英国の郵便番号かどうか（決定的な形式チェックとアウトコード／インコードの分割）

データ

洪水データは、オープンデータとしてOpen Government Licence v3.0の下で公開されている、環境庁の**「洪水リスク：郵便番号検索ツールデータ」**（イングランド）です。各郵便番号には、河川、海、または地表水による長期リスクが高（年間 3.3％以上）、中（1～3.3％）、低（0.1～1％）に該当する住所の数（これらのうち最も高い区分）と、別個の地下水に関する 可能性あり／可能性低い の表示が含まれています。およそ四半期ごとに更新されます。

このリポジトリには、テストをすぐに実行できるよう、説明用のスターターサンプル（地理的な場所を示さない ZZ の疑似郵便番号）が含まれています。このデータからの応答には、すべて dataset: "sample" のタグが付与されます。実データを読み込むには、data.gov.uk または Defra Data Services Platform から Postcodes_Risk_Assessment_All.csv をダウンロードし、次のコマンドを実行してください。

npm run build-data /path/to/Postcodes_Risk_Assessment_All.csv 2025-Q4
npm run build && npm test

帰属表示：Open Government Licence v3.0 に基づいてライセンスされた公共部門の情報を含みます。© 環境庁の著作権および／またはデータベース権。 NOTICE を参照してください。

これは 対象外です

• 助言ではありません。 保険、引受査定、測量、住宅ローン、法律に関する助言ではなく、物件単位の調査でもありません。
• すべての洪水の種類を網羅していません。 道路排水溝、下水道、地表流による洪水は対象外です。地下水は別個に報告され、主要な区分には含まれません。
• 英国全域を対象としていません。 対象はイングランドのみです（上記を参照）。
• 推測はしません。 不明な郵便番号や対象範囲外の郵便番号には、リスクレベルを捏造せず、正直に「見つかりません」と返します。

アーキテクチャ

単一の TypeScript パッケージで、インポート可能なライブラリと同じ core.ts のツール定義を使用する、stdio 経由（ローカル／npx）の単一 MCP サーバーを提供します。将来のホスト型エッジエンドポイントに向けて、Cloudflare Worker のエントリーポイントも含まれています。イングランド全域のデータセット（郵便番号約 160 万件）は Worker のバンドルサイズ上限を超えるため、ホスト型ビルドではデータを Cloudflare D1 に移行する予定です（後続対応）。npm ライブラリと stdio サーバーでは、データセット全体を直接実行できます。

npm install
npm run build
npm test

プライバシー

このツールはお使いのマシン上でローカルに動作し、データを収集、保存、送信しないように構築されています。分析、テレメトリー、アカウントは不要です。参照データはすべて同梱されているため、ネットワーク呼び出しはなく、お使いのデバイスからデータが外部に送信されることもありません。ポリシー全文はこちらです：https://qinisolabs.github.io/privacy.html。

ライセンス

Apache-2.0。洪水データ © Environment Agency、Open Government Licence v3.0。NOTICE を参照してください。