It Normattiva

@pipeworx/it-normattiva

イタリアの国家法令を検索し、URN:NIR の正確な引用を解決して、任意の日付時点における 1 条文の原文を読み取れます（複数時点の施行履歴）。公布日（Gazzetta Ufficiale）は、制定日および施行日と分けて扱います。

Pipeworx の一部です。AI エージェントを 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"）、および／または日付範囲でイタリアの国家法令を検索します。すべての結果には、以下の 2 つのツールにそのまま渡せる、生成された 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"。プライバシー法典）を解決し、タイトル、法令の種類、制定日、Gazzetta Ufficiale の公布日、冒頭の本文（前文から第 1 条の冒頭まで）を返します。as_of（YYYY-MM-DD）を指定すると、その日付時点で施行されている版を解決します（複数時点の施行履歴）。original: true を指定すると、制定時の原文を返します。
• it_normattiva_get_article(urn, article, annex?, as_of?, original?) — 指定した日付時点における法令の 1 条文の原文を返します（例：article: "1"、"12-bis"）。urn は条文サフィックスを含まない法令自体の引用です。annex を指定すると、本体ではなく付属書内の条文を選択します。公布日、制定日、施行開始日／終了日はすべて別々のフィールドとして返され、統合されることはありません。

get_act と get_article は、該当するものがない場合や複数に解決される場合、エラーではなく found: false と message を返します。引用が実際に曖昧な場合（多くの場合、同じ法令が Gazzetta Ufficiale の複数の付録で再掲載されています）は、candidates リストも返します。

認証

キーは不要です。

データソース

• Istituto Poligrafico e Zecca dello Stato（IPZS）、Normattiva Open Data — イタリアの公式統合法令データベースです（法律、緊急政令、立法政令、憲法、規則、その他の国家法令）。閣僚評議会議長府のために公開されています。すべての法令は URN:NIR の引用により条文ごとに参照でき、改正後の本文に加えて、各施行期間が記録されたすべての過去の版を含む、完全な複数時点の施行履歴を備えています。

注記

• Multivigenza の具体的な動作： アップストリームでは、引用にセレクターを追加してバージョンを解決します（「この日に有効」には !vig=<date>、「制定時点の内容」には @originale）。このパックでは、呼び出し元がサフィックスを手作業で組み立てなくても済むよう、これらを as_of ／ original として公開しています。
• 第 1 条のテキストには、通常、前文全体が含まれます。 イタリアの政令や法律では、制定文とすべての「VISTO .../VISTA ...」の前文が、アップストリームから返される同じ構造ブロック内の「Art. 1」より前に配置されています。そのため、article: "1" を指定した it_normattiva_get_article（および条項を指定しない it_normattiva_get_act）は、条文そのものの前に長い前文のテキストを返すことがあります。これはソース自体の構造であり、このパックによる切り捨てや重複ではありません。
• act_type と urn の条文種別セグメントは関連していますが、表記は同じではありません。 URN のセグメントでは、公式名称の単語をドットでつなぎ、ハイフンもドットに置き換えます（"DECRETO LEGISLATIVO" -> "decreto.legislativo"、"DECRETO-LEGGE" -> "decreto.legge"）。可能な場合は、手作業で作成せず it_normattiva_search の結果から URN を作成してください。
• キー不要のライブプロキシです。ツール呼び出し 1 回につき、アップストリームへのリクエストは 1 回です。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 サーバーを 2 つ目に追加せずに済みます。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによって増えるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの 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