Zornade MCP - Italian Cadastre, Geospatial and Real Estate Data

Zornade MCP - 意大利地籍、地理空间与房地产数据

用于意大利地籍、地理空间和房地产数据的模型上下文协议服务，由 Zornade API v2 提供支持。

将其添加到任意 MCP 客户端（Claude、Cursor、VS Code Copilot、Cline 等），即可用自然语言询问意大利房产相关问题：地理编码、地籍地块、风险图层、估值、太阳能潜力和行政区划列表。

端点

https://mcp.zornade.com/mcp

身份验证

需要免费的 Zornade API 密钥（zrn_...），可从 https://app.zornade.com/api 获取。通过 x-api-key 请求头、Authorization: Bearer 或 ?api_key= 查询参数发送。 速率限制和作用域取决于你的密钥（每小时 10,000 次请求）。

工具

工具	描述
zornade_geocode_search	对 1,870 多万个意大利地址进行正向地理编码（ANNCSU）
zornade_geocode_reverse	根据 WGS84 坐标进行反向地理编码
zornade_parcel_by_id	丰富的地籍地块资料（风险、经济、太阳能、估值、兴趣点等）
zornade_parcel_locate	按点、多个点或边界框查找地块
zornade_parcel_search	按 comune、foglio、label 查找地块
zornade_admin_lists	大区、省、市镇列表

连接

Claude Code：

claude mcp add zornade -t http https://mcp.zornade.com/mcp \
  --header "x-api-key: zrn_YOUR_KEY"

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "zornade": {
      "type": "http",
      "url": "https://mcp.zornade.com/mcp",
      "headers": { "x-api-key": "zrn_YOUR_KEY" }
    }
  }
}

测试

curl -X POST https://mcp.zornade.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: zrn_YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

示例

典型对话：从自然语言问题到结构化回答：

1. 用户提问：“这个地块有洪水风险吗？它值多少钱？”
2. Agent 使用 { "query": "via del corso 1, roma" } 调用 zornade_geocode_search， 然后使用返回的 fid 调用 zornade_parcel_by_id。
3. 返回的答案是包含英文字段名的精简 JSON：

{
  "fid": 28007851,
  "municipality": { "code": "H501", "name": "Roma", "province": "Roma", "region": "Lazio" },
  "cadastral": { "foglio": "481", "urban_section": null, "municipality_code": "H501", "postal_code": "00186" },
  "risk": { "seismic_zone": 3, "pga": 0.058, "flood_level": null, "landslide_level": null },
  "subsidence": { "velocity_mm_year": -0.8, "risk_class": 1, "risk_label": "negligible", "direction": "stable" },
  "economics": { "avg_residential_price_m2": 6283.33, "tax_year": 2023 },
  "meta": { "licenses": ["..."], "zornade_attribution_required": true }
}

（为简洁起见，以上内容有所删节；工具回复中省略了几何数据。）整个 API 的字段名均为英文（area_m2、pga、risk_label 等）。少数官方地籍术语会特意保留意大利语（foglio、sezione），而街道、市镇和大区名称等值属于专有名称，也会保持原样。

架构

• functions/mcp/index.ts - Supabase Edge Function（Deno），基于 mcp-lite + Hono 构建，使用可流式传输的 HTTP 传输方式。模式参考 Supabase 官方 MCP 指南。
• netlify.toml + public/ - Netlify 反向代理，为 mcp.zornade.com 提供简洁的主机名（无需构建步骤）。

文档

• API 文档：api.zornade.com
• API 密钥：app.zornade.com/api
• 主站：zornade.com

已知限制

• HTTP 传输是无状态的：不支持持久 SSE 会话。一些较新的 SDK 客户端会在初始化后建立持久 SSE GET 请求，并收到 400；请求/响应调用仍可正常工作，此错误无关紧要。
• 协议修订版本协商：服务支持 2025 年的 MCP 修订版本（2025-03-26 和 2025-06-18）。如果客户端请求更新或未知的修订版本，服务会返回支持的最早版本，而不是报错。
• 工具回复仅包含文本：省略几何数据，以减轻大模型的上下文负担。
• 调用工具需要免费的 Zornade API 密钥。对于批处理流水线，直接调用 API v2 才是合适的工具，详见 api.zornade.com。

许可证

分为两个不同的层面：

• 服务端代码：MIT。 可免费使用、修改和再分发，也可用于商业用途。完整文本见 LICENSE。
• 数据：适用原始来源的许可证，这些许可证对 API 和此服务的所有使用者均持续有效。 主要包括：
  • 地籍地块和地籍数据：Agenzia delle Entrate（可免费再利用，但须注明来源）
  • 地址：ANNCSU、ISTAT 和 Agenzia delle Entrate（CC BY 4.0，部分为 CC BY 3.0 IT）
  • 建筑物和地图图层：OpenStreetMap（ODbL 1.0）
  • 风险和环境图层：ISPRA、INGV、Copernicus（CC BY 4.0 / Copernicus Data Policy）
  • 太阳能潜力：PVGIS-SARAH3、JRC European Union（可免费再利用）
  • 房地产市场数据：OMI 和 MEF（可免费再利用）

每个 API 响应都会在 meta.licenses 中列出适用的许可证和所需的来源标注。来源标注分为两个级别：来源标注始终为必需；免费套餐密钥还必须标注“Dati elaborati da Zornade”并附上 zornade.com 链接，商业许可证则可免除此项（响应字段 meta.zornade_attribution_required 会告知适用哪条规则）。完整条款：zornade.com。