Italy OpenData

italy-opendata-mcp

イタリアのオープンデータ（自治体、県、州、郵便番号、座標、地理データ）を、シンプルで開発者に使いやすいツールを通じて公開する MCP サーバーです。

機能

• イタリアの行政区分をたどるための 7 つの MCP ツール
• 公式ソース：利用可能な場合は ISTAT と ANPR
• 遅延ダウンロード：初回使用時にデータを取得し、ローカルにキャッシュします（SQLite、約 1.8 MB）
• 初回使用後はオフラインで利用可能：すべてのクエリはローカルで実行されます
• Docker 不要：uvx または pip でインストールでき、Claude とともに起動・終了します

データソース

データ	ソース	種別
自治体、県、州、ISTAT コード	ISTAT	公式
居住人口	ANPR	公式（日次更新）
面積、標高、標高区分	ISTAT	公式
郵便番号（CAP）	comuni-json	コミュニティ（公式ソースはありません）
重心座標	opendatasicilia	コミュニティ（公式ソースはありません）

インストール

uvx italy-opendata-mcp

.mcp.json での使用方法

{
  "mcpServers": {
    "italy-opendata": {
      "command": "uvx",
      "args": ["italy-opendata-mcp"]
    }
  }
}

ソースから

git clone https://github.com/stucchi/italy-opendata-mcp.git
cd italy-opendata-mcp
uv venv && uv pip install -e .

ツール

階層ナビゲーション

list_regioni()  →  list_province(regione="Lombardia")  →  list_comuni(provincia="MI")

ツール	パラメーター	説明
list_regioni	—	すべての 20 州と自治体数、人口
list_province	regione?	任意の州フィルターを指定して県を取得
list_comuni	regione?, provincia?, limit?	任意のフィルターを指定して自治体を取得（デフォルトは 400 件）

検索

ツール	パラメーター	説明
get_comune	nome_o_codice	名前または ISTAT コードで自治体の詳細を取得
get_by_cap	cap	郵便番号に該当する自治体を検索

データ管理

ツール	パラメーター	説明
refresh_dataset	force?	ソースからデータを再ダウンロード
datasets_status	—	ローカルキャッシュの状態

自治体ごとに利用できるフィールド

各自治体には以下の情報が含まれます。

• 登録情報：名前、ISTAT コード、地籍コード、県の略称、県、州
• 人口統計：人口（ANPR、日次更新）
• 地理情報：緯度、経度、面積（km²）、標高（m）、標高区分
• 分類：沿岸、島嶼、都市化度
• 郵便情報：関連する CAP コードの一覧

出力例

> get_comune("Roma")

{
  "codice_istat": "058091",
  "nome": "Roma",
  "codice_catastale": "H501",
  "popolazione": 2802399,
  "superficie_kmq": 1288.19,
  "altitudine": 20,
  "zona_altimetrica": "Pianura",
  "litoraneo": 1,
  "latitudine": 41.89332,
  "longitudine": 12.482932,
  "sigla_provincia": "RM",
  "provincia": "Roma",
  "regione": "Lazio",
  "cap": ["00118", "00119", "00120", ...]
}

キャッシュ

データは初回使用時にローカルに保存されます。

OS	パス
macOS / Linux	~/.cache/italy-opendata-mcp/italia.db
Windows	%LOCALAPPDATA%\italy-opendata-mcp\italia.db

データを更新するには、refresh_dataset(force=True) を使用してください。

データの網羅状況

	件数
州	20
県	107
自治体	7,896
人口データあり	7,896
座標データあり	7,889
地理データあり	7,519
郵便番号データあり	7,887

ライセンス

MIT