parcel-gis-mcp-server

Третий коннектор в наборе Hutton SIR Research Agent (наряду с коннекторами FEMA NFHL и Municode). Предоставляет окружные/штатные данные об участках и идентификацию слоев ГИС путем прямого обращения к государственным ArcGIS REST сервисам — тот же шаблон «обойти JS-портал, запросить сервис напрямую», который сделал коннектор FEMA рабочим.

Никаких API-ключей. Каждый вышестоящий источник — это публичная конечная точка.

Что это решает

Самый частый класс сбоев в запусках SIR: порталы участков первого уровня (qPublic/Schneider, pbcpao.gov, OCPA, LOJIC apps) отображаются через JS или заблокированы токенами, а единственное зеркало второго уровня (FloridaParcels) работает только во Флориде и ненадежно. Этот сервер разрешает первичный ключ SIR §0A — идентификатор участка — по открытым слоям ArcGIS, на которых работают эти порталы, и добавляет поиск точки в полигоне (зонирование, землепользование, WMD, границы города) плюс высоту USGS.

Инструменты

Центроид из parcel_lookup напрямую передается в коннектор FEMA (fema_flood_zone_lookup) и gis_elevation_at_point — идентификатор участка на входе, зона затопления + высота на выходе, с координатами согласно Правилу качества 8.

Реестр (src/registry.ts)

Охват расширяется за счет добавления записи в реестр, а не написания кода — кодовая зеркальная копия Реестра порталов юрисдикций. Каждая запись содержит дату verified или false (= ⟨verify at run⟩). Поставляемые начальные данные:

• 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 — шаблон PVA по округам на kygisserver (⟨verify at run⟩; Webster подтверждено наличие, Jefferson/Scott подтверждено отсутствие)

• tn-statewide-tdec — зеркало участков штата TDEC для рынка Чаттануги (⟨verify at run⟩; вернуло 403 одному небраузерному клиенту 2026-08-17)

• Identify layers: ky-jefferson-landuse (✅ перечислен), fl-wmd-boundaries + fl-municipal-boundaries (URL для закрепления при первом использовании)

Подключение новой юрисдикции: gis_raw_query к каталогу /rest/services округа → найти слой участков/зонирования → прочитать его схему полей (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.