gazzetta-mcp

gazzetta-mcp

非官方的本地 MCP 服务，可让你的 AI 助手查阅意大利《Gazzetta Ufficiale》。免费、开源（MIT）。无需代码或日期。

English | 意大利语

你可以向助手询问：

• “伦巴第大区有面向护士的公开招聘考试吗？”
• “《Gazzetta》今天发布了什么？”
• “给我……法令的文本，并用三点总结。”
• “给我第 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	从冷启动状态搜索公开招聘考试：加载第 4 系列最近约 30 天的内容（进行少量受频率限制的请求，之后使用缓存），并说明覆盖范围
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。

要使用源码版本，请将 command/args 替换为 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	每秒最大请求数
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	Feed 缓存有效期（秒）
GAZZETTA_MCP_USER_AGENT	gazzetta-mcp/<version> (unofficial open source client)	随请求发送的 User-Agent

故障排除

首先运行 gazzetta-mcp --prova（或 uvx gazzetta-mcp --prova）：它会检查 Python、本地搜索、缓存文件夹和连接（发送一个请求），并告诉你需要修复什么。

• 助手看不到工具：添加服务后，完全重启助手；检查其配置中的命令（见上文），并运行 --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）。

---

意大利语

本地、非官方的 MCP 服务，可让你的 AI 助手查阅 Gazzetta Ufficiale。免费且开源（MIT 许可证）。 无需代码或日期。

你可以向助手提出的问题：

• “伦巴第大区有护士招聘考试吗？”
• “今天的 Gazzetta 上发布了什么？”
• “给我……相关法令的文本，并用三点概括。”
• “给我第 241/1990 号法律的 Normattiva 链接。”

结果可能不完整：服务可以查看近期发布的内容以及它已查阅过的内容，而非整个档案，并会说明这一点。然后前往“安装”。

使用方法

1. 将 Gazzetta 连接到助手（只需一次，见“安装”和“配置 MCP 客户端”），然后重启助手。
2. 用自己的话写下你需要什么，无需代码或日期：“伦巴第大区有护士招聘考试吗？”“今天的 Gazzetta 上发布了什么？”“给我第 241/1990 号法律的 Normattiva 链接。”
3. 务必打开回复中提供的官方链接：这些文本并非官方文本，结果也可能不完整。

更多示例请见 docs/uso.md。

声明

本项目并非官方出版物，也未与 Gazzetta Ufficiale 或 Istituto Poligrafico e Zecca dello Stato 建立关联。 返回的文本不具备真实性，且免费提供。唯一具有最终效力的文本是通过印刷方式刊登在 Gazzetta Ufficiale 上的文本；如有出入，以该文本为准。每条回复都会注明来源并附上官方链接：请务必先核对官方文本，再据此行事。

使用规则

• 仅在用户提出请求时才会发起请求。
• 不进行批量下载，也不会复制网站内容。
• 结果保存在你电脑上的本地缓存（SQLite）中。
• 发出的请求有频率限制（默认：每秒 1 次）。
• 请求会使用可识别的 user-agent。

这些是我们为本地服务设定的做法，并非来源方规定的规则；来源方只要求注明来源，并声明文本不具备真实性且免费提供。参见 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）。