It Normattiva

@pipeworx/it-normattiva

意大利国家立法——搜索、解析精确的 URN:NIR 引用，并读取任意日期的一条法条原文（多版本生效），同时将公布日期（《官方公报》）与颁布日期和生效日期分别记录。

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

工具

• it_normattiva_search(query?, title?, act_type?, in_force_on?, emanation_date_from?, emanation_date_to?, publication_date_from?, publication_date_to?, limit?, offset?) — 按全文词语、标题词语、官方法案类型（例如 "LEGGE"、"DECRETO LEGISLATIVO"、"DECRETO-LEGGE"、"COSTITUZIONE"、"REGOLAMENTO"）和／或日期范围搜索意大利国家法案。每条结果都包含一个构造好的 urn 字段（法案类型、日期和编号——例如 urn:nir:stato:decreto.legislativo:2003-06-30;196），可直接传给下面两个工具。自由文本 query 会在整个语料库中按词进行 OR 匹配，而非精确匹配短语——可通过 title／act_type／日期缩小范围，获得更精准的结果。
• it_normattiva_get_act(urn, as_of?, original?) — 解析精确的引用（URN:NIR，例如 "urn:nir:stato:decreto.legislativo:2003-06-30;196"，即《隐私法典》），并返回标题、法案类型、颁布日期、《官方公报》公布日期和开篇文本（从序言到第 1 条开头）。as_of（YYYY-MM-DD）用于解析该日期生效的版本（多版本生效）；original: true 则返回最初颁布时的文本。
• it_normattiva_get_article(urn, article, annex?, as_of?, original?) — 返回某法案中一条法条的原文（例如 article: "1"、"12-bis"），可指定日期。urn 是不带法条后缀的法案引用；annex 用于选择附件中的法条，而非正文中的法条。公布日期、颁布日期以及生效起止日期都会作为独立字段返回，不会合并在一起。

如果无法解析出任何结果或解析出多个结果，get_act 和 get_article 都会返回 found: false 和一条 message，而不是报错；如果引用确实存在歧义（最常见的情况是同一法案在多期《官方公报》增刊中重复发布），还会附带一个 candidates 列表。

身份验证

无需密钥。

数据来源

• Istituto Poligrafico e Zecca dello Stato（IPZS），Normattiva Open Data——意大利官方综合法律数据库（涵盖法律、法令、立法法令、宪法、法规及其他国家法案），由 Presidenza del Consiglio dei Ministri 发布。每项法案都可通过其 URN:NIR 引用逐条访问，并包含完整的多版本生效历史——经修订的文本，以及每个历史版本各自的生效时间范围。

说明

• **Multivigenza，具体来说：**上游通过在引文后追加选择器来解析版本（!vig=<date> 表示“在此日期生效”，@originale 表示“按颁布时版本”）——此工具包将其作为 as_of / original 提供，而不是让调用方手动拼接后缀。
• **第 1 条的文本通常包含完整序言。**意大利法令和法律会在上游返回的同一结构块中，将颁布公式以及每条“VISTO .../VISTA ...”陈述放在“Art. 1”之前，因此，调用 it_normattiva_get_article 并设置 article: "1"（以及调用不带 article 的 it_normattiva_get_act）可能会返回一大段位于条文本身之前的序言文本——这是来源自身的结构，并非此工具包造成的截断或重复。
• **act_type 与 urn 中的法案类型部分相关，但写法不同。**URN 部分会用点连接官方标签中的单词，并将连字符也转换为点（"DECRETO LEGISLATIVO" -> "decreto.legislativo"，"DECRETO-LEGGE" -> "decreto.legge"）。尽可能根据 it_normattiva_search 结果构建 URN，而不要手动构建。
• 无需密钥的实时代理。每次工具调用只发起一个上游请求。工具包中不包含也不镜像任何 Normattiva 内容（网关包已接近容量上限——请参阅 docs/international-legal-scope.md）。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/it-normattiva/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 都会连接到同一个网关和同一组 1815+ 数据源。唯一的区别是哪些工具包的工具会被直接列出；通过任一端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/it_normattiva_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"protezione dei dati personali","act_type":"DECRETO LEGISLATIVO","limit":3}'

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

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

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

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

或者直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-it-normattiva

它通过 stdin/stdout 使用 MCP 协议，并为此工具包专属的工具响应 initialize / tools/list / tools/call——不包含上述网关连接额外提供的共享元工具。数据源和工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT