hr-eli-mcp

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 もブロックされるため、pip install ではなく python -m pip でインストールしてください。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.hr
• HR_ELI_CACHE_DIR - デフォルト値は ~/.matematic/cache/hr-eli
• HR_ELI_AUDIT_DIR - デフォルト値は ~/.matematic/audit

API キーは不要です。Narodne novine のオープンデータはキーなしで利用できます。

ガバナンス

• 公開データのみ - Narodne novine に対して読み取り専用でアクセスします。クライアントのデータがマシンの外部に送信されることはありません。
• 監査ログ - すべてのツール呼び出しは ~/.matematic/audit/hr-eli-mcp.jsonl に JSON 形式の行を 1 行追記します。
• ベンダー中立 - narodne-novine.nn.hr のみと通信します。LLM プロバイダーは使用せず、テレメトリーもありません。
• 検証可能な引用情報 - すべての応答は 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。