关于 hr-eli-mcp
hr-eli-mcp 是面向需要查阅《Narodne novine》官方公报中克罗地亚法律的用户的 MCP 服务。它支持按公报期次发现文件、获取元数据和官方 HTML 正文,并提供欧洲 ELI 标识符及可核验引文。
主要功能
- 01列出公报期次中的文件
- 02按期次引用获取文件元数据
- 03获取官方 HTML 正文
- 04提供欧洲 ELI 标识符
- 05返回来源链接和引文详情
适用场景
- 01发现某一期发布的文件
- 02查询已知文件的元数据
- 03获取克罗地亚法律的官方正文
MCP 相关
向 MCP 客户端提供列出公报期次文件、获取克罗地亚法律元数据和官方正文的工具。响应包含 ELI 标识符和来源链接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
4收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| year | integer | 是 | 例如:``2018``。 |
| issue | integer | 是 | 公报期号,例如 ``42``(来自类似 "NN 42/2018" 的引文)。 |
详细介绍
hr-eli-mcp
面向克罗地亚官方公报 Narodne novine(narodne-novine.nn.hr)的 MCP 服务。它可获取带有欧洲 ELI 标识符和可验证引文的克罗地亚法律。
属于 MateMatic eu-legal-mcp 生产线的一部分,已支持 PL、DE、AT、ES、FI、IE、NL、SE、FR、LU、DK 和 CZ。沿用相同的引文约定,数据源为 Narodne novine。克罗地亚原生支持欧洲 ELI 本体(data.europa.eu/eli),每份文件都提供 JSON-LD 元数据。
范围。 此 MVP 可列出某期公报中的文件、返回每份文件的 JSON-LD 元数据,并获取官方 HTML 正文。文件通过年份、期号和文件编号定位;公报采用路径查询,而非关键词搜索。覆盖范围为 1990 年至今。语言:克罗地亚语。每个响应都包含
dataset_note。许可。 Narodne novine 是克罗地亚官方公报。本连接器以只读方式转发内容,并注明来源及
source_url。
工具
| 工具 | 功能 |
|---|---|
hr_list_issue | 按年份和期号列出某期公报中的文件(发现)。 |
hr_get_act | 按年份、期号和文件编号获取文件元数据。 |
hr_get_text | 获取文件完整的官方 HTML 正文。 |
hr_coverage | 说明此连接器的覆盖范围、各类别的捕获时间,以及明确说明未覆盖的内容。每项缺口都附有备用方案。 |
每个响应都包含以下约定字段:eli_uri(欧洲 ELI URL,例如
https://narodne-novine.nn.hr/eli/sluzbeni/2018/42/805)、human_readable_citation
(标题 + NN 42/2018)和 source_url。
安装
发布到 PyPI 后,无需安装即可运行:
uvx hr-eli-mcp
也可从源代码运行:
cd hr-eli-mcp
pip install -e .
配置(Claude Code / 任意 MCP 客户端)
{
"mcpServers": {
"hr-eli-mcp": { "command": "hr-eli-mcp" }
}
}
启用了 Smart App Control 的 Windows 11
Smart App Control 会阻止未签名的可执行文件,包括 uvx.exe、pip.exe
以及 pip 在安装时写入的 hr-eli-mcp.exe 启动器。python.org 安装程序提供的
python.exe 和 py.exe 由 Python Software
Foundation 签名,因此通过解释器运行模块即可:
python -m pip install hr-eli-mcp
python -m hr_eli_mcp
出于相同原因,pip.exe 也会被阻止,因此请使用 python -m pip 安装,而不要使用
pip install。如果 python 不在 PATH 中,请使用 Windows 启动器:py -3 -m hr_eli_mcp。
{ "mcpServers": { "hr-eli-mcp": { "command": "python", "args": ["-m", "hr_eli_mcp"] } } }
请勿为了绕过此问题而关闭 Smart App Control——关闭后,只有重新安装 Windows 才能重新启用。
环境变量:
HR_ELI_BASE_URL- 默认值为https://narodne-novine.nn.hrHR_ELI_CACHE_DIR- 默认值为~/.matematic/cache/hr-eliHR_ELI_AUDIT_DIR- 默认值为~/.matematic/audit
无需 API 密钥。Narodne novine 开放数据无需密钥即可访问。
治理
- 仅限公共数据 - 以只读方式访问 Narodne novine;不会有客户端数据离开本机。
- 审计日志 - 每次工具调用都会向
~/.matematic/audit/hr-eli-mcp.jsonl追加一行 JSON。 - 厂商中立 - 只连接
narodne-novine.nn.hr;不使用大模型提供商,也不进行遥测。 - 可验证的引文 - 每个响应都可通过
source_url独立核验。
请参阅 CONSTITUTION.md 和 DISCOVERY.md。
测试
pip install -e ".[dev]"
pytest tests/test_instructions_drift.py tests/test_parse.py -v # offline
pytest tests/test_smoke.py -v # hits live Narodne novine
许可
Apache-2.0。© Matematic Solutions / Wieslaw Mazur。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。