Zornade MCP - Italian Cadastre, Geospatial and Real Estate Data

Zornade MCP - イタリアの地籍・地理空間・不動産データ

Zornade API v2を利用した、イタリアの地籍、地理空間、不動産データ向けのModel Context Protocolサーバーです。

任意のMCPクライアント（Claude、Cursor、VS Code Copilot、Clineなど）に追加して、ジオコーディング、地籍区画、リスクレイヤー、評価額、太陽光発電のポテンシャル、行政区分の一覧など、イタリアの不動産について自然言語で質問できます。

エンドポイント

https://mcp.zornade.com/mcp

認証

https://app.zornade.com/apiから取得できる無料のZornade APIキー（zrn_...）が必要です。x-api-keyヘッダー、Authorization: Bearer、または?api_key=クエリパラメーターで送信してください。レート制限とスコープはお使いのキーに適用されます（1時間あたり10,000リクエスト）。

ツール

ツール	説明
zornade_geocode_search	1,870万件以上のイタリアの住所（ANNCSU）を対象とするフォワードジオコーディング
zornade_geocode_reverse	WGS84座標によるリバースジオコーディング
zornade_parcel_by_id	リスク、経済、太陽光、評価額、POIなどを含む拡張地籍区画プロフィール
zornade_parcel_locate	点、複数の点、またはバウンディングボックスによる区画の検索
zornade_parcel_search	comune、foglio、地番による区画の検索
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. エージェントはzornade_geocode_searchを{ "query": "via del corso 1, roma" }で呼び出し、続いて返された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 - mcp-liteとHonoを使用し、ストリーミング可能なHTTPトランスポートを実装したSupabase Edge Function（Deno）です。公式のSupabase MCPガイドのパターンを採用しています。
• netlify.toml + public/ - クリーンなホスト名mcp.zornade.com向けのNetlifyリバースプロキシです（ビルド手順は不要です）。

ドキュメント

• 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）をサポートしています。クライアントがこれより新しいリビジョン、または不明なリビジョンを要求した場合、エラーではなく、サポート対象のうち最も古いリビジョンが返されます。
• ツールの応答はテキストのみです。LLMのコンテキストを軽く保つため、ジオメトリは省略されます。
• ツールの呼び出しには無料のZornade APIキーが必要です。バッチパイプラインにはAPI v2を直接呼び出すのが適しています。詳しくはapi.zornade.comをご覧ください。

ライセンス

異なる2つのレイヤーがあります。

• サーバーコード：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 に、必要な帰属表示テキストが記載されています。帰属表示には2つのレベルがあります。ソースの帰属表示は常に必須です。「Dati elaborati da Zornade」の帰属表示と zornade.com へのリンクは無料プランのキーで必要ですが、商用ライセンスがあれば免除できます（どちらのルールが適用されるかは、レスポンスフィールド meta.zornade_attribution_required で確認できます）。利用規約全文：zornade.com。