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 分

    请在仓库或注册中心条目中声明许可证。