Istat It

mcp-istat-it

ISTAT（Istituto Nazionale di Statistica）MCP —— 通过公共 SDMX 2.1 REST Web 服务访问意大利国家统计数据。无需身份验证或 API 密钥。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1882+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供商无关联，未获其认可，也不是由其发布。

工具

工具	描述
list_dataflows	浏览或按关键字搜索 ISTAT 数据集（dataflow）。每个结果都包含一个 id（传递给 get_data / dataflow_structure 的 dataflowId）和一个英文名称。ISTAT 发布了约 4,800 个数据集，因此除非确实需要完整列表，否则始终传入 query 进行筛选。例如：list_dataflows({ query: "unemployment" }) 或 list_dataflows({ query: "GDP" }).
dataflow_structure	获取一个 ISTAT 数据集的结构（数据结构定义）：其有序维度，以及每个维度的有效代码。可用它了解如何构建供 get_data 使用的点分隔 SDMX 键。键中的位置与维度顺序对应；留空表示通配符。例如：dataflow_structure({ dataflow_id: "101_1015" }).
get_data	从 ISTAT 数据集中提取观测值。key 是点分隔的 SDMX 维度筛选条件，每个位置对应 dataflow_structure 给出的维度顺序；留空表示该位置使用通配符。例如：get_data({ dataflow_id: "101_1015", key: "A.IT...", start_period: "2021", end_period: "2023" }) 会选择年度（A）、REF_AREA=IT（意大利），并将其余维度设为通配符。省略 key（或传入 ""）可获取所有序列——请注意，数据量可能很大。返回解码后的序列，包含维度标签和各时期的值。

快速开始

将其添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "istat-it": {
      "url": "https://gateway.pipeworx.io/istat-it/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/istat-it/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：单个工具包端点目前除工具包自身工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天情况的权威说明。

这是刻意如此，并非意外复用。元工具可让受限连接回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需你再添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请改为连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和同一批 1882+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/istat_it_list_dataflows \
  -H 'Content-Type: application/json' \
  -d '{"query":"unemployment"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/istat_it_list_dataflows。查找工具包：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

{
  "mcpServers": {
    "istat-it": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-istat-it"]
    }
  }
}

也可以直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-istat-it

它通过 stdin/stdout 传输 MCP，并针对仅属于此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接添加的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Istat It data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT