br-eli-mcp

br-eli-mcp

登録不要・API キー不要のブラジルの主要なオープンデータ API 8 種に対応する MCP サーバーです。

1. Camara dos Deputados（dadosabertos.camara.leg.br）- 連邦議会の立法 プロセス：法案（proposicoes）が委員会での審議や本会議での採決を経る過程を確認できます。
2. Congresso Nacional Dados Abertos Legislativos（legis.senado.leg.br/dadosabertos）- 成立したNormas Juridicas（法律、政令、憲法改正）の正式なLexML URN Lexリゾルバーです。識別情報、Diario Oficial da Uniaoでの公布情報、改正履歴、STFによる違憲性に関する注記を確認できます。
3. normas.leg.br - （2）を補完する全文サービスです。同じURN Lexを使って、成立した法令の実際の条文を条ごとに参照できます。
4. DataJud CNJ（api-publica.datajud.cnj.jus.br）- STJ／TST／TSE／TRFs／TJs／TRTs／TREsおよび軍事裁判所を対象とする、裁判案件のDOCKETメタデータ（判決文は含みません）です。
5. STJ Open Data Portal（dadosabertos.web.stj.jus.br）- ブラジルで2番目に上位の裁判所であるSuperior Tribunal de Justicaの実際のacordao（判決）全文とementa（判決要旨）を取得できます。対象期間は2022年5月以降です。
6. CARF（acordaos.economia.gov.br）- ブラジル連邦税務不服審判委員会の実際のacordao（税務判決）全文を、正確な事件番号／決定番号で取得できます。
7. TST（jurisprudencia-backend2.tst.jus.br）- ブラジルの労働最高裁判所、Tribunal Superior do Trabalhoの実際の判決全文（inteiro teor）とementaを取得できます。フリーテキスト検索と、正確なCNJ事件番号による検索に対応しています（すべての種類の文書を合わせて、acordao 3,751,594件、文書8,483,448件。2026-07-07にライブ環境で確認）。
8. TCU（pesquisa.apps.tcu.gov.br）- 連邦会計検査院であるTribunal de Contas da Uniaoの実際のacordao全文（審議、報告者の報告書、投票）を取得できます。公共調達に関する判例を収録しています（acordao 525,620件。2026-07-07にライブ環境で確認）。

これは何か（そして何ではないか）

br_get_norma は、Senado 独自の API ゲートウェイ（公開されており、キーも登録も不要）に対して urn:lex:br:... を解決し、識別情報、公開の出典情報、改正履歴を返します。br_get_norma_index と br_get_norma_texto は、同じ URN を normas.leg.br の構造化された法令ツリーに対して解決し、要約ではなく、実際の条文を取得します。両エンドポイントがどのように見つかったかは、DISCOVERY.md を参照してください。v0.1.0 では識別情報の取得先ホストを誤り、未確認と報告していました。v0.2.0 でその問題は修正されましたが、全文の取得には対応していませんでした。v0.3.0 では、人間が読める引用ページと同じドメインに全文 API があることが判明しました。

このコネクターは Planalto（planalto.gov.br）の HTML をスクレイピングしません。すべての法令種別について URN Lex と Planalto の URL を対応づける、確認済みの機械的な規則がなく、URL を捏造すれば、このツール群が防ごうとしている引用の幻覚という失敗を招くおそれがあるためです。2026-07-07 に実際の稼働状況を再確認したところ、legislacao.presidencia.gov.br（マニフェストに記載された REFLEGIS ポータル）は、キーなしのクライアントに通常の HTTP 応答を一切返しませんでした。接続は受け付けられますが、リクエストは受信バイト数がゼロのままタイムアウトします。これは構造化 API ではなく、前段にボット対策／WAF がある状況と一致します。法令種別の一部（主に政令）では、normas.leg.br にも本文が掲載されていません。その場合は DISCOVERY.md を参照してください。

判例については、DataJud（事件管理メタデータのみ。CNJ Resolution 446/2022 により再配布に制限あり）、STJ Open Data Portal（実際の判決文、2022 年 5 月以降）、CARF（実際の税務裁決文、完全一致検索のみ）、TST（実際の判決文。フリーテキスト検索と CNJ プロセス番号の完全一致検索の両方について、以前のリバースエンジニアリングでは見落としていたリクエスト項目が実際のフロントエンドのブラウザーネットワークトレースで判明したため、2026-07-07 に稼働を確認）、および TCU（実際の判決文／報告書／意見書）の各サービスを以下に接続しています。TRF4／TRF5 は調査の結果、接続を見送りました。これらのホストはブラジル国外からの接続を一切受け付けないためです（geo_restricted）。また、RFB の sijut2consulta はスクレイピング対象に分類される HTML アプリであり、JSON バックエンドはありません。実施した調査の詳細と、確認済みの各リクエスト／レスポンス仕様については DISCOVERY.md を参照してください。

ツール

ツール	用途
br_search_proposicoes	種類（PL、PLP、PEC、...）と年で法案を一覧表示します
br_get_proposicao	1件の法案について、詳細情報と現在のステータスを取得します（IDで指定）
br_get_norma	成立した法令（Norma Juridica）を URN Lex で特定し、識別情報、官報（DOU）の出典、改正履歴、STF の注記を取得します
br_get_norma_index	法令の参照可能な構造（部、編、章、節、条）を一覧表示します
br_get_norma_texto	法令の1つの条文（dispositivo）の本文を取得します
br_search_processos	1つの裁判所の DataJud CNJ インデックスで、裁判案件（メタデータのみ）を検索します
br_get_processo	CNJ 統一事件番号を完全一致で指定し、1件の裁判案件を取得します
br_search_case_stj	事件番号またはフリーテキストで STJ 判決（判決本文）を検索します
br_get_case_stj	事件番号を完全一致で指定し、1件の STJ 判決を取得します。判決要旨と判決本文が含まれます
br_get_case_carf	事件番号または決定番号を完全一致で指定し、1件の CARF 税務判決を取得します。判決要旨と判決本文が含まれます
br_search_case_tst	フリーテキストで TST 労働裁判所の判決を検索します（判決本文、判決375万件）
br_get_case_tst	CNJ 統一事件番号を完全一致で指定し、1件の TST 判決を取得します。判決要旨と判決全文が含まれます
br_search_case_tcu	フリーテキストで TCU（連邦会計検査院）の判決を検索します（判決52万5,000件）
br_get_case_tcu	（番号、年、合議体）で TCU の判決を取得します。審議内容、報告書、投票の本文が含まれます
br_coverage	このコネクターの対象範囲、各分野のデータ取得時期、対象外の内容を明示します。対象範囲のすべての空白に代替手段が用意されています。

参考：法案の種類コード（sigla_tipo）：

コード	ポルトガル語	英語
PL	Projeto de Lei	通常法案
PLP	Projeto de Lei Complementar	補完法案（憲法規定を実施するもの）
PEC	Proposta de Emenda a Constituicao	憲法改正案

すべての応答には lex_uri、human_readable_citation、source_url が含まれます。 br_search_proposicoes／br_get_proposicao の場合、lex_uri は Camara 独自の安定した API URI です（URN Lex ではありません。法案はまだ成立した法律ではないためです）。br_get_norma の場合、 lex_uri は照会した実際の urn:lex:br:... です。例： "urn:lex:br:federal:lei:2002-01-10;10406"（民法典）。br_get_norma_texto の場合、 lex_uri は条文のサフィックスを追加した URN です。例："...;10406!art5"。

インストール

Claude プラグインとして（Claude Code またはデスクトップアプリ。 uv が必要です）：

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

通常の Python パッケージとして：

pip install br-eli-mcp

Smart App Control が有効な Windows 11

Smart App Control は署名されていない実行ファイルをブロックします。これには uvx.exe、pip.exe と、インストール時に pip が書き込む br-eli-mcp.exe ランチャーが含まれます。python.org のインストーラーに含まれる python.exe と py.exe は Python Software Foundation によって署名されているため、インタープリター経由でモジュールを実行できます。

python -m pip install br-eli-mcp
python -m br_eli_mcp

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

{ "mcpServers": { "br-eli-mcp": { "command": "python", "args": ["-m", "br_eli_mcp"] } } }

この問題を回避するために Smart App Control を無効にしないでください。無効にすると、Windows を再インストールしない限り再有効化できません。

設定

環境変数	デフォルト
BR_ELI_CACHE_DIR	~/.matematic/cache/br-eli
BR_ELI_AUDIT_DIR	~/.matematic/audit
BR_ELI_BASE_URL	https://dadosabertos.camara.leg.br/api/v2
BR_ELI_NORMA_BASE_URL	https://legis.senado.leg.br/dadosabertos
BR_ELI_TEXT_BASE_URL	https://normas.leg.br/api/public
BR_ELI_DATAJUD_BASE_URL	https://api-publica.datajud.cnj.jus.br
BR_ELI_STJ_BASE_URL	https://dadosabertos.web.stj.jus.br
BR_ELI_CARF_BASE_URL	https://acordaos.economia.gov.br/solr/acordaos2/select
BR_ELI_TST_BASE_URL	https://jurisprudencia-backend2.tst.jus.br
BR_ELI_TCU_BASE_URL	https://pesquisa.apps.tcu.gov.br/rest/publico/base/acordao-completo

データ

サーバーはお使いのマシン上で動作します。各ツール呼び出しでは、クエリが上記の公式ブラジル公共 API（Camara、Senado、normas.leg.br、DataJud CNJ、STJ、TST、TCU、CARF）のいずれかに送信されます。MateMatic に送信されるものはありません。クエリと結果は、ほかのメッセージと同様に、お使いのモデルを経由します。

スタンドアロンサーバーは初回使用時に一度だけ、このリポジトリの GitHub Releases から小さな設定ファイル（br-runtime.json.gz、更新されたソースアドレス）も取得します。このリクエストにクエリの内容は含まれません。確認できる利用状況の指標は、このファイルの GitHub ダウンロード数のみです。BR_ELI_RUNTIME_URL="" を設定すると無効になり、Claude プラグインでは無効に設定されています。

ホームディレクトリ内に、次の 2 つがローカル保存されます。

• レスポンスキャッシュ（~/.matematic/cache/br-eli）。同じ検索を繰り返しても、ソースに再度アクセスしないようにします。裁判所の判決は公開記録であり、当事者の名前が記載されている場合があります。
• 監査ログ（~/.matematic/audit/br-eli-mcp.jsonl）。ツール呼び出し 1 回につき 1 行で、ツール名、入力の SHA-256 ハッシュ（入力そのものではありません）、結果のサイズ、時刻、ステータスを記録します。

いずれのフォルダーもいつでも削除できます。BR_ELI_CACHE_DIR と BR_ELI_AUDIT_DIR を設定すると、保存先を変更できます。

ライセンス

Apache-2.0（コード）。Camara dos Deputados のオープンデータ API は、出典表示が必要なオープンデータです。詳しくは SOURCES.md をご覧ください。