br-eli-mcp

br-eli-mcp

面向 8 个无需密钥、无需注册的巴西开放数据 API 的 MCP 服务：

1. Camara dos Deputados（dadosabertos.camara.leg.br）——联邦立法流程：法案（proposicoes）在委员会审议和全体会议表决中的进展。
2. Congresso Nacional Dados Abertos Legislativos（legis.senado.leg.br/dadosabertos）——真正的 LexML URN Lex 解析器，用于已颁布的 Normas Juridicas（法律、法令、宪法修正案）：识别信息、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 及军事法院的法院案卷元数据（不含裁决文本）。
5. STJ Open Data Portal（dadosabertos.web.stj.jus.br）——巴西第二高法院 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 案件编号查询（共 3,751,594 份 acordaos、8,483,448 份各类型文档——经实时验证，日期为 2026-07-07）。
8. TCU（pesquisa.apps.tcu.gov.br）——联邦审计法院 Tribunal de Contas da Uniao 的真实 acordao 全文（审议内容、报告员报告、投票）：提供公共采购判例（共 525,620 份 acordaos——经实时验证，日期为 2026-07-07）。

这是什么（以及不是什么）

br_get_norma 会通过参议院自己的 API 网关（公开、无需密钥或注册），解析 urn:lex:br:...，并返回识别信息、公布来源和修订历史。br_get_norma_index + br_get_norma_texto 则会通过 normas.leg.br 的结构化立法树解析相同的 URN，获取某一条款的真实文本——而非摘要。有关这两个端点的发现过程，请参阅 DISCOVERY.md：v0.1.0 在识别信息查询中测试了错误的主机，并错误地将结果报告为未确认；v0.2.0 修正了这一问题，但仍缺少全文；v0.3.0 则在与人类可读引文页面相同的域名上找到了全文 API。

此连接器不会抓取 Planalto（planalto.gov.br）的 HTML——目前没有经确认的机械规则可以将 URN Lex 映射到每种法案类型对应的 Planalto URL；若自行编造映射，就有可能造成这支工具集旨在避免的引文幻觉问题。2026-07-07 重新进行实时验证：legislacao.presidencia.gov.br（清单中提到的 REFLEGIS 门户）完全不会向无密钥客户端返回普通 HTTP 响应——它会接受连接，但请求会超时，且接收字节数为零。这与其前方存在机器人验证/WAF 相符，而非结构化 API。少数法案类型（主要是法令）在 normas.leg.br 中也没有内嵌文本；有关这些法案，请参阅 DISCOVERY.md。

下方已接入判例法相关数据源：DataJud（仅提供案件元数据；根据 CNJ 第 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	获取某项法案的完整详情和当前状态，按 ID 查询
br_get_norma	通过 URN Lex 解析已颁布的 Norma Juridica——识别信息、DOU 来源、修订历史、STF 备注
br_get_norma_index	列出 Norma 的可寻址结构（部分、编、标题、章、节、条）
br_get_norma_texto	获取 Norma 某一条（dispositivo）的实际文本
br_search_processos	在某一法院的 DataJud CNJ 索引中搜索法院案件卷宗（仅元数据）
br_get_processo	按确切的 CNJ 统一案件编号获取一份法院案件卷宗
br_search_case_stj	按案件编号或自由文本搜索 STJ 判决（实际裁决文本）
br_get_case_stj	按确切的案件编号获取一份 STJ 判决——摘要和裁决正文
br_get_case_carf	按确切的案件卷宗编号或决定编号获取一份 CARF 税务判决——摘要和裁决正文
br_search_case_tst	按自由文本搜索 TST 劳动法院裁决（实际裁决文本；375 万份判决）
br_get_case_tst	按确切的 CNJ 统一案件编号获取一份 TST 裁决——摘要和全文
br_search_case_tcu	按自由文本搜索 TCU（联邦审计法院）判决（52.5 万份判决）
br_get_case_tcu	按（numero、ano、colegiado）获取一份 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"（Codigo Civil）。对于 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 也会因相同原因被阻止，因此请使用 python -m pip 安装，而不要使用 pip install。如果 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 插件默认关闭该功能。

以下两项会写入你的主目录：

• 响应缓存（~/.matematic/cache/br-eli），这样重复查询就不会再次访问来源。法院裁决属于公开记录，可能会包含当事人姓名。
• 审计日志（~/.matematic/audit/br-eli-mcp.jsonl），每次工具调用占一行：工具名称、输入的 SHA-256 哈希值（不含输入本身）、结果大小、时间和状态。

你可以随时删除任一文件夹；使用 BR_ELI_CACHE_DIR 和 BR_ELI_AUDIT_DIR 可以更改它们的位置。

许可证

Apache-2.0（代码）。Camara dos Deputados 开放数据 API 属于开放数据，使用时须注明出处——请参阅 SOURCES.md。