hu-eli-mcp

hu-eli-mcp

ハンガリーの公式国内法令データベース、Nemzeti Jogszabalytar（NJT、njt.jog.gov.hu）向けの MCP サーバーです。MKIFK によって運営されています。AI エージェントに、ネイティブ ELI（European Legislation Identifier）で特定したハンガリーの法令を提供し、検証可能な引用情報（ELI そのもの、人が読める形式の引用、公式ソースへのリンク）を示します。

MateMatic による eu-legal-mcp シリーズの一部です。EU 加盟国ごとにコネクターがあり、どこでも同じ引用形式を使用します。

ELI について。 オランダとスウェーデン（このシリーズの初期コネクターで、どちらもネイティブ ELI を公開していません）とは異なり、ハンガリーには 2023 年以降、正式に文書化された本格的な国内 ELI 実装があります（njt.jog.gov.hu/eli/urisemak）。そのため、eli_uri はツールが解決した実際の /eli/ URI であり、代替識別子ではありません。DISCOVERY.md を参照してください。

ツール

ツール	説明
hu_get_act(year, serial)	ELI によるハンガリーの法律（torveny）のメタデータです。例：年 2013、通し番号 5（民法典）。発行者コードは不要です。
hu_get_legislation(doc_type, year, issuer, serial)	ELI による、その他の法令（政令など）のメタデータです。種別、年、発行者（大文字と小文字を区別）、通し番号を指定します。
hu_get_text(doc_type, year, serial, issuer=None)	法律またはその他の法令の全文 HTML コンテンツです。
hu_list_doc_types()	有効な NJT 文書種別コード（例：TV＝法律、R＝政令）です。
hu_list_issuers()	有効な NJT 発行者コード（例：Korm＝政府）です。大文字と小文字の正確な表記が重要です。
hu_coverage()	このコネクターの対象範囲、各種別の取得時期、そして明示的に対象外となる範囲を示します。各対象外項目には代替手段があります。

すべてのレスポンスに引用情報一式が含まれます。

• eli_uri — 解決されたネイティブ ELI URI。例：https://njt.jog.gov.hu/eli/TV/2013/5。
• human_readable_citation — 解析したタイトルと副題から生成されます。例： 「2013. évi V. törvény (a Polgári Törvénykönyvről)」。
• source_url — ブラウザーで閲覧できる njt.jog.gov.hu/jogszabaly/... の文書ページです。

フリーテキスト検索には対応していません

NJT には REST/JSON API がなく、検索・閲覧 UI はセッションが必要な JavaScript SPA のため、ヘッドレス環境では使用できません。文書は既知の ELIで指定する必要があります。有効なコードを確認するには hu_list_doc_types / hu_list_issuers を使用し、その後 hu_get_act / hu_get_legislation を実行してください。解決できない ELI（年、通し番号、発行者が間違っている場合や、発行者コードの大文字・小文字が異なる場合）は not_found として返されます。NJT は 404 ではなく、検索補助ページにリダイレクトします。

インストール

Claude プラグインとして（Claude Code またはデスクトップアプリで使用。 uv が必要です）。送信・保存する内容については plugin/README.md を参照してください。

/plugin marketplace add matematicsolutions/hu-eli-mcp
/plugin install hu-eli-mcp@hu-eli-mcp

pip install -e ".[dev]"

MCP クライアントに登録します（.mcp.json.example を参照）。

{
  "mcpServers": {
    "hu-eli-mcp": {
      "command": "hu-eli-mcp",
      "env": {
        "HU_ELI_BASE_URL": "https://njt.jog.gov.hu",
        "HU_ELI_CACHE_DIR": "~/.matematic/cache/hu-eli",
        "HU_ELI_AUDIT_DIR": "~/.matematic/audit"
      }
    }
  }
}

Smart App Control を有効にした Windows 11

Smart App Control は署名のない実行ファイルをブロックします。対象には uvx.exe、pip.exe、および pip がインストール時に作成する hu-eli-mcp.exe ランチャーが含まれます。python.org のインストーラーに含まれる python.exe と py.exe は Python Software Foundation による署名済みのため、インタープリター経由でモジュールを実行できます。

python -m pip install hu-eli-mcp
python -m hu_eli_mcp

同じ理由で pip.exe もブロックされるため、pip install ではなく python -m pip でインストールしてください。python が PATH にない場合は、Windows ランチャーを使用してください：py -3 -m hu_eli_mcp。

{ "mcpServers": { "hu-eli-mcp": { "command": "python", "args": ["-m", "hu_eli_mcp"] } } }

回避策として Smart App Control を無効にしないでください。無効にすると、Windows を再インストールしない限り再度有効にできません。

設計

• 公開データのみ。 キー不要の公式サイト njt.jog.gov.hu に対して読み取り専用です。解決する ELI パス以外の情報は送信されません。robots.txt を遵守し（/search/* は呼び出しません）。
• 監査ログ。 呼び出しのたびに ~/.matematic/audit/hu-eli-mcp.jsonl に JSON の行を 1 行追記します（記録用）。
• ネットワーク - サーバーは、上記の公式ソースとローカルファイルシステムにアクセスします。また、初回使用時に一度だけ、このリポジトリの GitHub Releases から小さな設定ファイル（hu-runtime.json.gz、更新されたソースアドレス）を取得します。このリクエストにクエリ内容は含まれません。把握できる利用状況の指標は、GitHub によるこのファイルのダウンロード数のみです。HU_ELI_RUNTIME_URL="" を設定すると無効になります。Claude プラグインでは無効になっています。LLM プロバイダーも、それ以外のテレメトリーもありません。独自のバックオフとディスク上のキャッシュを使用します。
• 捏造なし。 ELI、タイトル、引用情報は、解決された文書ページから解析されます。NJT のマークアップが変更された場合、コネクターは古いデータや捏造したデータを返さず、明確にエラーを報告します。

CONSTITUTION.md（4 つの原則）と DISCOVERY.md（ソースの特定方法。njt.hu → njt.jog.gov.hu のドメイン発見と、発行者コードの大文字・小文字に関する注意点を含む）を参照してください。

テスト

pytest tests/test_instructions_drift.py   # offline
pytest tests/test_smoke.py                 # live NJT

ライセンス

Apache-2.0。提供されるハンガリーの法令は、ハンガリーの公式公開データです。このコネクターは、これに対する権利を追加しません。