gazzetta-mcp

gazzetta-mcp

AI アシスタントがイタリアの Gazzetta Ufficiale を参照できる、非公式のローカル MCP サーバーです。無料のオープンソース（MIT）です。コードや日付は不要です。

英語 | イタリア語

アシスタントに依頼できること：

• 「ロンバルディア州で看護師の公募はありますか？」
• 「今日の Gazzetta には何が掲載されましたか？」
• 「…に関する政令の本文を、3つのポイントに要約してください。」
• 「法律 241/1990 の Normattiva リンクを教えてください。」

結果が一部に限られる場合があります。サーバーが参照できるのは最近の掲載情報と、これまでに検索した情報であり、アーカイブ全体ではありません。その旨も明示します。次にインストールをご覧ください。

免責事項

このプロジェクトは公式刊行物ではなく、Gazzetta Ufficiale または Istituto Poligrafico e Zecca dello Stato とは一切関係ありません。 返されるテキストは真正なものではなく、無料で提供されます。確定版のテキストは印刷版の Gazzetta Ufficiale に掲載されたもののみであり、相違がある場合はそちらが優先されます。すべての応答には出典と公式リンクが含まれます。内容を利用する前に、必ず公式のテキストをご確認ください。

出典サイトの参考文言： "確定版のテキストは印刷版の Gazzetta Ufficiale に掲載されたもののみであり、相違がある場合はそちらが優先されます。電子形式で提供されるテキストは、出典を明記し、真正なものではなく無料であることを示せば、複製が許可されます。"

利用ポリシー

• リクエストは、あなたまたはアシスタントが何かを依頼したときに限り、必要に応じて行われます。
• 一括ダウンロードやサイトのミラーリングは行いません。
• 結果は、お使いのマシン上のローカルキャッシュ（SQLite）に保存されます。
• 外部へのリクエストにはレート制限を適用します（デフォルトでは毎秒1件）。
• リクエストには識別用 User-Agent（gazzetta-mcp/<version> (unofficial open source client)）が付与されます。

これらはローカルサーバーにおける独自の方針であり、出典元が定めたルールではありません。出典元が求めているのは、出典を明記し、テキストが真正なものではなく無料であることを示すことだけです。デフォルト設定を変更せず、出典元に配慮してご利用ください。docs/fonti.mdをご覧ください。

ツール

ツール	パラメーター	機能
ultime_pubblicazioni	serie, giorni	過去 N 日間の系列（SG、S1-S5、P2）の最新掲載情報
sommario	data, serie	指定した日付と系列の号の目次
leggi_atto	codice, data, serie, offset	編集コード（例：26A05182）から取得した法令の本文
cerca_concorsi	parole_chiave, regione, aperti, includi_altri_atti, limite	初回検索時に過去約30日分の第4系列を読み込み、公募を検索します（レート制限付きリクエストが数件発生し、その後キャッシュされます）。検索範囲を明示します
rimando_normattiva	atto	法令の Normattiva 永続リンクを生成します（リンクのみ。ダウンロードはしません）
cerca	testo, serie, tipo, dal, al, limite, aggiorna	最近の号のタイトルと概要を検索します（SG と S4 は範囲を限定して先に更新）。さらに、すでにキャッシュされているすべての情報も検索します。法令の全文は、すでに読み込まれている場合にのみ対象となります

系列コード：SG Serie Generale、S1 Corte Costituzionale、S2 Unione Europea、S3 Regioni、 S4 Concorsi ed esami、S5 Contratti pubblici、P2 Parte II。

インストール

Python 3.10 以降と uv が必要です。uv はサーバーをダウンロードして実行する、小型の無料ツールです（uvx コマンドを提供します）。Windows では PowerShell を開き、winget install --id astral-sh.uv を実行してから、ターミナルを再度開いてください。

uvx gazzetta-mcp
# or
pip install gazzetta-mcp

ソースから（現在動作します）

uvx --from git+https://github.com/GiovannaFilippini/gazzetta-mcp gazzetta-mcp

MCP クライアントを設定する

Claude Code

claude mcp add gazzetta -- uvx gazzetta-mcp

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "gazzetta": {
      "command": "uvx",
      "args": ["gazzetta-mcp"]
    }
  }
}

Cursor（~/.cursor/mcp.json）と Windsurf：Claude Desktop と同じ mcpServers ブロックを使用します。

VS Code（.vscode/mcp.json）

{ "servers": { "gazzetta": { "type": "stdio", "command": "uvx", "args": ["gazzetta-mcp"] } } }

汎用 stdio クライアント：コマンド gazzetta-mcp（または uvx gazzetta-mcp）を実行し、stdin/stdout 経由で MCP を使用します。

ソースから実行する場合は、コマンドと引数を uvx --from git+https://github.com/GiovannaFilippini/gazzetta-mcp gazzetta-mcp に置き換えます。

設定

すべての設定は環境変数で、src/gazzetta_mcp/config.py で読み込まれます。

変数	デフォルト値	説明
GAZZETTA_MCP_GU_BASE_URL	https://www.gazzettaufficiale.it	Gazzetta Ufficiale サイトのベース URL
GAZZETTA_MCP_NORMATTIVA_BASE_URL	https://www.normattiva.it	Normattiva リンクに使用するベース URL
GAZZETTA_MCP_RPS	1.0	1 秒あたりの最大リクエスト数
GAZZETTA_MCP_TIMEOUT	20.0	HTTP タイムアウト（秒）
GAZZETTA_MCP_CACHE_PATH	<cache dir>/gazzetta-mcp/cache.sqlite3	SQLite キャッシュファイル（LOCALAPPDATA、なければ XDG_CACHE_HOME、それもなければ ~/.cache）
GAZZETTA_MCP_FEED_TTL	900	フィードキャッシュの有効期間（秒）
GAZZETTA_MCP_USER_AGENT	gazzetta-mcp/<version> (unofficial open source client)	リクエストに付加される User-Agent

トラブルシューティング

まず gazzetta-mcp --prova（または uvx gazzetta-mcp --prova）を実行してください。Python、ローカル検索、 キャッシュフォルダー、接続（リクエスト 1 件）を確認し、修正が必要な項目を知らせます。

• アシスタントにツールが表示されない：サーバーを追加した後、アシスタントを完全に再起動し、 設定内のコマンドを確認して（上記参照）、--prova を実行してください。
• 結果が空になる：別のキーワードや、より少ないキーワードを試すか、最近公開されたものを尋ねてください。結果が 一部のみの場合があります（上記参照）。見つからないものがあれば、公式サイトを確認してください。
• 最初の検索が遅い：最初のリクエストでローカルキャッシュが作成されます。次回以降は速くなります。
• キャッシュの場所：<cache dir>/gazzetta-mcp/cache.sqlite3（上記の GAZZETTA_MCP_CACHE_PATH を参照。 Windows では %LOCALAPPDATA%\gazzetta-mcp）。
• キャッシュを消去する：アシスタントを閉じてから、gazzetta-mcp --svuota-cache --si を実行してください （--si を付けない場合は、削除される内容を表示するだけです）。

開発

uv sync
uv run pytest            # no network needed
uv run ruff check .
uv run pytest --live     # also runs tests that call the real sites (use sparingly)

CONTRIBUTING.md、docs/piano.md、docs/decisioni を参照してください。

ライセンス

MIT。ライセンスの対象はコードのみです。テキストには、各情報源の規則が適用されます （docs/fonti.md を参照）。

---

イタリア語

あなたの AI アシスタントが Gazzetta Ufficiale を参照できるようにする、ローカルで非公式の MCP サーバーです。無料のオープンソース（MIT ライセンス）です。 コードや日付を指定する必要はありません。

アシスタントに尋ねられること：

• 「ロンバルディア州で看護師の採用試験はありますか？」
• 「今日、官報に何が掲載されましたか？」
• 「…に関する政令の本文を、3 つのポイントにまとめてください。」
• 「法律 241/1990 の Normattiva リンクを教えてください。」

サーバーが参照するのは最近の刊行物と、これまでに参照した内容であり、全アーカイブではないため、結果が 一部のみの場合があります。その場合はその旨を伝えます。続いて「インストール」に進んでください。

使い方

1. Gazzetta をアシスタントに接続します（一度だけです。「インストール」と 「MCP クライアントの設定」を参照）。その後、アシスタントを再起動します。
2. コードや日付を使わず、自分の言葉で必要なことを入力します：「ロンバルディア州で看護師の採用試験は ありますか？」「今日、官報に何が掲載されましたか？」「法律 241/1990 の Normattiva リンクを教えてください。」
3. 回答に記載された公式リンクを必ず開いてください：テキストは公式のものではなく、 結果が不完全な場合があります。

その他の例は docs/uso.md を参照してください。

注意事項

このプロジェクトは公式な出版物ではなく、Gazzetta Ufficiale およびIstituto Poligrafico e Zecca dello Statoとは一切関係ありません。 返されるテキストは非公式であり、無料で提供されます。確定版のテキストは印刷媒体で公開されたGazzetta Ufficialeのもののみであり、相違がある場合はそちらが優先されます。すべての回答には出典と公式リンクが記載されています。利用する前に、必ず公式テキストを確認してください。

利用ルール

• リクエストはユーザーからの要求があった場合のみ実行されます。
• 一括ダウンロードやサイトのコピーは行いません。
• 結果はお使いのコンピューター上のローカルキャッシュ（SQLite）に保存されます。
• 外部へのリクエストには頻度制限があります（既定値：1秒あたり1件）。
• リクエストには識別可能なユーザーエージェントを使用します。

これらはローカルサーバーに関する独自の選択であり、出典が定めたルールではありません。出典が求めているのは、出典を明記し、テキストが非公式かつ無料であることを示すことだけです。docs/fonti.mdをご覧ください。

ツール

ツール	パラメーター	機能
ultime_pubblicazioni	serie、giorni	過去N日間のシリーズ別最新刊行物
sommario	data、serie	指定した日付とシリーズの号の目次
leggi_atto	codice、data、serie、offset	編集コードから法令のテキストを取得します（例：26A05182）
cerca_concorsi	parole_chiave、regione、aperti、includi_altri_atti、limite	キャッシュが空の場合でも公募を検索します（第4シリーズ）。過去30日分を読み込み（少数のリクエストを間隔を空けて実行し、その後キャッシュに保存）、検索対象の範囲を明示します
rimando_normattiva	atto	Normattivaへの永続リンクを作成します（リンクのみ）
cerca	testo、serie、tipo、dal、al、limite、aggiorna	最近の号のタイトル（SGは約30日分、S4は直近9件。上限を設けて先に更新）、キャッシュ内のデータ、および任意の年の法律・政令についてはNormattivaのオープンデータアーカイブ（出典 normattiva）を検索します。全文を取得できるのは、すでに閲覧した法令のみです

自然言語でのリクエスト例：docs/uso.md。

インストール

Python 3.10+とuvが必要です。uvは、サーバーを代わりにダウンロードして起動する小さな無料プログラムです（uvxコマンドを提供します）。WindowsではPowerShellを開き、winget install --id astral-sh.uvと入力してから、ターミナルを閉じて開き直してください。

uvx gazzetta-mcp
# oppure
pip install gazzetta-mcp

ソースからのインストール（現在利用可能）：

uvx --from git+https://github.com/GiovannaFilippini/gazzetta-mcp gazzetta-mcp

MCP クライアントの設定

• Claude Code：claude mcp add gazzetta -- uvx gazzetta-mcp
• Claude Desktop：上記のmcpServersブロックをclaude_desktop_config.jsonに追加します。
• その他のクライアント：gazzetta-mcpをstdioサーバーとして起動します。

環境変数GAZZETTA_MCP_*については、上記の「Configuration」表をご覧ください。

問題が発生した場合

まずgazzetta-mcp --prova（またはuvx gazzetta-mcp --prova）を実行してください。Python、ローカル検索、キャッシュフォルダー、接続（リクエスト1件のみ）を確認し、修正が必要な箇所を示します。

• アシスタントにツールが表示されない：サーバーを追加した後、アシスタントを完全に再起動し、設定内のコマンドを確認して--provaを実行してください。
• 結果がない：別のキーワードを試すか、キーワードを減らすか、最近公開された内容を尋ねてください。結果は一部のみの場合があります。何か不足している場合は、公式サイトを確認してください。
• 最初の検索に時間がかかる：最初のリクエストではローカルメモリ（キャッシュ）を作成します。以降の検索はより速くなります。
• キャッシュの場所：<cartella cache>/gazzetta-mcp/cache.sqlite3（Windowsでは%LOCALAPPDATA%\gazzetta-mcp）です。GAZZETTA_MCP_CACHE_PATHで変更できます。
• キャッシュを空にする：アシスタントを終了し、gazzetta-mcp --svuota-cache --siを実行してください（--siを付けない場合は、削除される内容だけが表示されます）。

開発

uv sync
uv run pytest          # senza rete
uv run ruff check .
uv run pytest --live   # include i test sui siti reali

CONTRIBUTING.mdを参照してください。ライセンス：MIT（コードに適用されます。テキストには引き続き各ソースの規則が適用されます。docs/fonti.mdを参照してください）。