parcel-gis-mcp-server

Hutton SIR Research Agent 套件中的第三个连接器（与 FEMA NFHL 和 Municode 连接器并列）。通过直接访问公共政府的 ArcGIS REST 服务 来公开县/州的 宗地数据 和 GIS 图层识别 查询——正是这种“绕过 JS 门户，直接查询底层服务”的模式让 FEMA 连接器得以工作。

无需 API 密钥。所有上游源都是公共端点。

它解决的问题

SIR 运行中最常见的一类失败：一级宗地门户（qPublic/Schneider、pbcpao.gov、OCPA、LOJIC 应用）要么是 JS 渲染，要么受令牌阻止；而唯一的二级镜像（FloridaParcels）仅限佛罗里达州且不可靠。该服务器针对这些门户所基于的开放 ArcGIS 图层解析 SIR §0A 主键——宗地标识符，并添加点在多边形内查询（分区区域、土地利用、WMD、城市边界）以及 USGS 高程。

工具

parcel_lookup 返回的质心可直接链接到 FEMA 连接器（fema_flood_zone_lookup）和 gis_elevation_at_point——输入宗地 ID，输出洪泛区 + 高程，坐标按照质量规则 8 传递。

注册表（src/registry.ts）

覆盖范围通过添加注册表条目而非编写代码来扩展——这是 Jurisdiction Portal Registry 在代码侧的镜像。每个条目携带一个 verified 日期或 false（= ⟨运行时验证⟩）。随附的种子：

• fl-statewide — FGIO/FDOR 地籍数据，涵盖佛罗里达州全部 67 个县（✅ 已验证 2026-08-17；架构已确认：PARCEL_ID、OWN_NAME、PHY_ADDR1、LND_SQFOOT、DOR_UC、S_LEGAL、SALE_*、JV）

• ky-jefferson — LOJIC 开放 OpenDataPVA 宗地（✅ 已验证 2026-08-17——位于 gis.lojic.org 的开放服务器，而非受令牌阻止的 apps.lojic.org 服务器；仅几何 + PARCELID/PIN/LRSN）

• ky-state-pva-pattern — kygisserver 按县划分的 PVA 模板（⟨运行时验证⟩；Webster 确认存在，Jefferson/Scott 确认不存在）

• tn-statewide-tdec — 面向查塔努加市场的 TDEC 全州宗地镜像（⟨运行时验证⟩；2026-08-17 曾对某个非浏览器客户端返回 403）

• 识别图层：ky-jefferson-landuse（✅ 已列出）、fl-wmd-boundaries + fl-municipal-boundaries（首次使用时固定的 URL）

接入新辖区： 对县的 /rest/services 目录执行 gis_raw_query → 找到宗地/分区图层 → 读取其字段架构（在图层根节点使用 f=json）→ 添加 ParcelSource/IdentifyLayer 条目 → 提交 → Render 自动部署。

本地开发

npm install
npm run build
npm start                      # listens on :3000, MCP endpoint = POST /mcp
node test/live-test.mjs        # smoke test against localhost

注意：在沙箱/代理环境中，出站调用可能被阻止；请改为针对已部署的 URL 运行冒烟测试：

node test/live-test.mjs https://YOUR-SERVICE.onrender.com/mcp

部署（GitHub → Render）

与 FEMA 和 Municode 连接器相同的过程——完整的分步说明请参阅 DEPLOYMENT.md。简而言之：将此仓库推送到 GitHub → 在 Render 中从仓库创建 "New Web Service" → 构建 npm install && npm run build，启动 npm start → 连接器 URL 为 https://<service>.onrender.com/mcp。