parcel-gis-mcp-server

Hutton SIR Research Agent スイートの3番目のコネクタ（FEMA NFHL および Municode コネクタと並ぶ）。公開されている政府の ArcGIS REST サービス に直接アクセスして、郡/州の パーセルデータ と GIS レイヤー識別 クエリを公開します。これは、FEMA コネクタを機能させたのと同じ「JS ポータルをバイパスし、その下のサービスにクエリを実行する」パターンです。

API キーは不要です。すべての上流ソースは公開エンドポイントです。

解決する問題

SIR 実行における最も一貫した障害クラス：Tier-1 パーセルポータル（qPublic/Schneider、pbcpao.gov、OCPA、LOJIC アプリ）は JS レンダリングまたはトークンブロックされており、唯一の Tier-2 ミラー（FloridaParcels）はフロリダのみで信頼性が低い。このサーバーは、それらのポータルが基盤としているオープンな ArcGIS レイヤーに対して SIR §0A プライマリキー（パーセル識別子）を解決し、ポイントインポリゴンルックアップ（ゾーニング地区、土地利用、WMD、市域）と USGS 標高を追加します。

ツール

parcel_lookup からの重心は、FEMA コネクタ（fema_flood_zone_lookup）および gis_elevation_at_point に直接チェーンされます — パーセル ID から、洪水ゾーン + 標高が出力され、座標は品質ルール 8 に従って運ばれます。

レジストリ（src/registry.ts）

カバレッジは コードを書くのではなく、レジストリエントリを追加することで 拡大します — 管轄区域ポータルレジストリのコード側ミラー。各エントリには 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）

新しい管轄区域のオンボーディング： 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。