Property Hazard MCP

us-property-hazard-risk（MCP 服务）

一个远程 MCP 服务，仅使用免费的公开数据（无需密钥），评估单个美国房产地址面临的自然灾害风险，包括洪水、野火、地震和沿海距离。无需 API 密钥、数据库或地图。可通过 Claude、ChatGPT 或任何其他兼容 MCP 的宿主使用。

工具

assess_property_hazard(address: str)

验证地址并进行地理编码，然后返回洪水区（FEMA NFHL）、野火风险评分、地震 PGA（USGS、ASCE 7-22）、断层和海岸距离，以及确定性的 0–100 hazard_score / hazard_tier 和最多 5 个 hazard_drivers。如果某个数据源不可用，相应字段将报告为未知，而不会假定风险为零。

数据来源

• 美国人口普查局地理编码器 — 地址验证和地理编码
• FEMA NFHL — 洪水区
• USGS 设计地图 — 地震 PGA
• 静态参考点（haversine）— 断层和海岸距离

本地开发

python -m venv venv
venv/Scripts/pip install -r requirements.txt   # venv/bin/pip on macOS/Linux

cd src
../venv/Scripts/python server.py               # ../venv/bin/python on macOS/Linux

在 http://localhost:8000/mcp 启动可流式传输的 HTTP MCP 服务：

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"assess_property_hazard","arguments":{"address":"1600 Pennsylvania Ave NW, Washington, DC 20500"}}}'

部署

通过 Docker Compose（docker-compose.yml）运行：

docker compose up -d --build

已知限制

• 仅支持美国地址
• 某些网络偶尔无法访问 FEMA NFHL（flood_available: false）
• 野火评分采用粗略的坐标区域启发式方法，不会精确到地块

许可证

MIT — 参见 LICENSE。