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

缓存

首次使用时，数据会保存在本地：

操作系统	路径
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