Italy OpenData

io.github.stucchi由 GitHub 帳號 stucchi 發布v1.0.2更新於 Oct 24, 2026

Italian open data: municipalities, provinces, regions, postal codes, coordinates.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理查詢義大利大區、省份與市鎮的開放資料，包含郵遞區號和座標。

可以做什麼
瀏覽行政區劃層級：列出大區、省份與市鎮，可依大區或省份篩選，市鎮清單附人口數並支援結果數量上限。依名稱或 ISTAT 代碼查詢單一市鎮，取得登記、人口、地理與郵政資訊。依郵遞區號（CAP）查找對應市鎮。查看本機快取狀態，或強制重新下載資料集。
適用情境
適合在對話中需要義大利地理或行政區劃資訊時使用：把城鎮名稱解析為所屬省份、大區、ISTAT 代碼或座標，把郵遞區號對應到市鎮，或比較義大利各市鎮的人口與面積。
執行需求
以 Python 套件（italy-opendata-mcp）在本機執行，透過 uvx 或 pip 啟動，因此需要 Python 環境及 uv。未宣告帳號、API 金鑰或環境變數。首次使用時下載資料並快取為本機 SQLite 檔案，因此首次需要網路存取，之後查詢都在本機完成。
安裝前請注意
首次使用會從外部來源下載資料，並在使用者快取目錄寫入 SQLite 快取；refresh_dataset 會重新下載。郵遞區號與中心點座標來自社群來源而非官方來源，可靠性可能低於 ISTAT 與 ANPR 欄位。市鎮清單預設最多回傳 400 筆，範圍過寬的查詢可能被截斷。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Italy OpenData，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

italy-opendata-mcp

MCP server exposing Italian open data (municipalities, provinces, regions, postal codes, coordinates, geographic data) through simple, developer-friendly tools.

Features

  • 7 MCP tools to navigate the Italian administrative hierarchy
  • Official sources: ISTAT and ANPR where available
  • Lazy download: data is fetched on first use and cached locally (~1.8 MB SQLite)
  • Offline after first use: all queries are local
  • No Docker: installable via uvx or pip, starts and stops with Claude

Data sources

DataSourceType
Municipalities, provinces, regions, ISTAT codesISTATOfficial
Resident populationANPROfficial (daily updates)
Surface area, altitude, altimetric zoneISTATOfficial
Postal codes (CAP)comuni-jsonCommunity (no official source available)
Centroid coordinatesopendatasiciliaCommunity (no official source available)

Installation

bash
uvx italy-opendata-mcp

Usage in .mcp.json

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

From source

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

Tools

Hierarchical navigation

list_regioni()  →  list_province(regione="Lombardia")  →  list_comuni(provincia="MI")
ToolParametersDescription
list_regioni—All 20 regions with municipality count and population
list_provinceregione?Provinces with optional region filter
list_comuniregione?, provincia?, limit?Municipalities with optional filters (default 400 results)

Search

ToolParametersDescription
get_comunenome_o_codiceFull details of a municipality by name or ISTAT code
get_by_capcapFind municipalities associated with a postal code

Data management

ToolParametersDescription
refresh_datasetforce?Re-download data from sources
datasets_status—Local cache status

Available fields per municipality

Each municipality includes:

  • Registry: name, ISTAT code, cadastral code, province abbreviation, province, region
  • Demographics: population (ANPR, daily updates)
  • Geography: latitude, longitude, surface area (km²), altitude (m), altimetric zone
  • Classification: coastal, island, urbanization degree
  • Postal: list of associated CAP codes

Example output

> 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", ...]}

Cache

Data is saved locally on first use:

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

To refresh data, use refresh_dataset(force=True).

Data coverage

Count
Regions20
Provinces107
Municipalities7,896
With population7,896
With coordinates7,889
With geographic data7,519
With postal codes7,887

License

MIT

來源：README.md，提交 6b6fb1d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。