floodwise

---

询问大模型“SW1A 1AA 的洪水风险是什么？”，它会自信地作答——但它无法知道：每个邮编对应的洪水风险是具体、经过整理的数据，存放在政府数据集中，而不在模型的权重中。floodwise 会在环境署官方的 “洪水风险：邮编查询工具” 数据中查找邮编，并返回真实的长期风险等级；若查不到，则如实返回 “未找到”，而不是猜测。

⚠️ 请先阅读——floodwise 的用途与限制

• 仅限英格兰。 数据来自环境署，覆盖范围为英格兰。威尔士（威尔士自然资源局）、苏格兰（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	英格兰邮编对应的环境署长期洪水风险等级（High/Medium/Low/Very Low）、各等级的地址数量，以及地下水风险提示
validate_postcode	这是格式正确的英国邮编吗？（确定性的格式检查 + outcode/incode 拆分）

数据

洪水数据来自环境署的**“洪水风险：邮编查询工具数据”（英格兰），以开放数据形式依据《开放政府许可协议 v3.0》**发布。每个邮编均列出周边区域长期洪水风险为高（≥3.3%/年）、中（1–3.3%）或低（0.1–1%）的地址数量，风险类型包括河流、海洋或地表水（取其中最高等级）；另有单独的地下水可能/不太可能提示。数据约每季度更新一次。

此代码库附带示例入门数据（非地理位置的 ZZ 伪邮编），确保测试开箱即用——使用该数据集的所有响应都会标记为 dataset: "sample"。如需加载真实数据，请从 data.gov.uk / Defra 数据服务平台下载 Postcodes_Risk_Assessment_All.csv，然后运行：

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

署名：包含依据《开放政府许可协议 v3.0》授权的公共部门信息。© 环境署版权及/或数据库权利。 详见 NOTICE。

它不是什么

• 不是建议。 不构成保险、承保、测绘、抵押贷款或法律建议，也不能替代房产级勘察。
• 不涵盖所有洪水类型。 不包括公路排水沟、下水道和地表径流导致的洪水；地下水风险单独报告，不纳入总体风险等级。
• 不覆盖整个英国。 仅限英格兰（见上文）。
• 不会猜测。 未知或超出覆盖范围的邮编会如实返回“未找到”，绝不会编造风险等级。

架构

一个 TypeScript 软件包，通过 stdio（本地 / npx）提供一个 MCP 服务，其底层由同一套 core.ts 工具定义驱动，这套定义也为可导入的库提供支持。软件包还包含一个 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。