MCP Juridico Brasil

将任意 AI 助手连接到 DataJud CNJ——已登记 92 个法院简称，支持期限计算、案件监控并符合 CPC 规定。

juridico.dehor.dev：项目页面，提供示例、安装说明和常见问题

简介 · 可用工具 · 安装 · 客户端配置 · 路线图 · 参与贡献

---

简介

mcp-juridico-brasil 将 AI 助手、律师事务所和案件管理系统连接到 DataJud CNJ——巴西国家司法委员会的统一司法数据集，其中登记了涵盖各类司法体系的 92 个法院简称（联邦、州、劳动、军事、选举和高等法院）。登记并不保证 DataJud 中包含该法院的数据：数据量取决于各法院向 CNJ 提交的数据。

该服务并非通用的公共数据目录。其定位是打造垂直案件处理能力：将零散的司法查询转化为安全、可组合且适用于 Agent 的工具——支持根据 CPC 按工作日计算期限、通过查询监控案件进展，并访问电子司法住所（Domicílio Judicial Eletrônico）。

---

可用工具

该服务注册了 9 个工具和 1 个资源（参见 src/mcp_juridico_brasil/server.py）。

案件查询与监控

工具	描述	来源
buscar_processo_por_numero	根据 CNJ 案件编号（NNNNNNN-DD.AAAA.J.TT.OOOO）查询完整案件信息	DataJud CNJ
listar_movimentacoes	案件进展历史记录，可按日期筛选	DataJud CNJ
resumir_andamento	案件数据，以及供语言模型生成摘要的指令	DataJud CNJ
monitorar_processo	告知指定日期以来是否有更新及最后更新时间（轮询，不保存快照）	DataJud CNJ
listar_processos_monitorados	列出会话中保存了快照的案件。此版本中没有任何查询工具会保存快照，因此列表为空	本地内存

案件期限计算

工具	描述	参考
calcular_proximo_prazo	按工作日计算期限，并计入司法休庭期和全国性节假日（CPC 第 219、220 和 224 条）。仅当提供 uf 时才会计入州级节假日	提供 data_intimacao_iso 时离线计算；未提供时查询 DataJud 并使用最近一次案件进展

法院参考

工具	描述	来源
listar_tribunais	列出服务中登记的 92 个缩写（CNJ 160/2020 号条例）	离线

电子司法住所（可选）

需要 DJe 专用凭证（DJE_CLIENT_ID、DJE_CLIENT_SECRET、DJE_BEHALF_OF_CPF）。

工具	描述	来源
listar_intimacoes	列出 DJe 收到的通知。只读；保密通知的内容会被隐藏	DJe（API Comunica）
confirmar_leitura_intimacao	确认已阅读通知。会产生实际法律效力并开始计算期限。 默认以 dry-run 模式运行，只有设置 confirmar=True 和 DJE_PERMITIR_CONFIRMACAO_LEITURA=true 才会确认	DJe（API Comunica）

MCP 资源

资源	描述
processo://{numero}/snapshot	如果存在，则读取已保存的案件快照。由于 buscar_processo_por_numero 和 monitorar_processo 不会保存快照，此版本会提示没有可用快照

---

安装

最简单的方式，无需永久安装任何内容：

uvx mcp-juridico-brasil

什么是 uvx？ 它是 uv 的工具管理器，可在隔离环境中下载并运行 Python 包，不会污染你的系统。如果你还没有安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh

保持更新： 使用 uvx mcp-juridico-brasil@latest 或 uvx --refresh mcp-juridico-brasil，强制使用 PyPI 上的最新版本。

永久安装（替代方案）

# via pip
pip install mcp-juridico-brasil

# via uv (recomendado para projetos Python)
uv add mcp-juridico-brasil

从源代码安装

git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil
uv sync

---

MCP 客户端配置

将以下代码片段粘贴到客户端的配置文件中。DATAJUD_API_KEY 变量是可选的：默认情况下，服务会使用 CNJ 在 datajud-wiki.cnj.jus.br 公布的当前公钥。由于 CNJ 可能随时更换密钥，必要时可使用此变量替换。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

重启 Claude Desktop。法律工具将自动显示。

Claude Code（CLI）

claude mcp add juridico-brasil -- uvx mcp-juridico-brasil

如需加入 API 密钥：

DATAJUD_API_KEY=sua-chave-aqui claude mcp add juridico-brasil -- uvx mcp-juridico-brasil

Cursor / .mcp.json

创建或编辑 .cursor/mcp.json（或项目根目录下的 .mcp.json）：

{
  "mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

VS Code + Continue

添加到 settings.json：

{
  "continue.mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

---

环境变量

变量	描述	默认值
DATAJUD_API_KEY	替换 DataJud CNJ 的默认公钥	CNJ 当前公钥
JURIDICO_LOG_LEVEL	日志级别：DEBUG、INFO、WARNING	INFO
JURIDICO_SNAPSHOT_DIR	用于持久化已保存快照的目录。此版本的查询工具不会保存快照	内存
JURIDICO_HTTP_TIMEOUT	DataJud HTTP 调用的超时时间（秒）	30

---

架构

Claude / GPT / Cursor / qualquer cliente MCP
              |
              | Model Context Protocol (stdio)
              v
    mcp-juridico-brasil
              |
    +---------+---------+-----------+----------+
    |         |         |           |          |
 Processos  Movim.   Resumo    Monitoram.  Prazos
    |         |         |           |          |
    v         v         v           v          v
 DataJud   DataJud   DataJud    DataJud   Calendario
  CNJ        CNJ       CNJ        CNJ      forense
                                           offline
              |
              v
   92 siglas de tribunais
  (Federal, Estadual, Trabalho,
   Militar, Eleitoral, Superior)

数据来源：

• DataJud CNJ - 统一司法数据数据库（CNJ 160/2020 号条例）
• 全国及各州司法日历 - 离线处理，用于计算期限（CPC 第 219/220/224 条）

---

路线图

• v0.1.x - 案件搜索、诉讼动态列表、进展摘要和法院列表
• v0.2.x - 按查询监控、按工作日计算期限（CPC）、按案件提供 MCP 资源
• v0.3.x - 更新推送 Webhook、数据库持久化和期限提醒
• v0.4.x（部分完成） - 通过电子司法住所（DJe）获取通知：列表和双重门控的阅读确认
• v0.4.x - 公告解析和结构化信息提取
• v1.0.0 - 完整诉讼套件，包含 LGPD 审计、稳定的 API 契约和扩展的覆盖范围

---

隐私与 LGPD

注意：诉讼查询工具仅访问 DataJud CNJ 提供的公开数据（CNJ 第 331/2020 号决议）；该 API 不会返回司法保密案件。可选的 DJe 工具则有所不同：使用律师本人的凭据，可访问其在电子司法住所（Domicílio Judicial Eletrônico）收到的非公开诉讼通知，但会隐去保密传票的内容，且 confirmar_leitura_intimacao 可能产生法律效力。任何诉讼数据都不会存储在用户本地环境之外，并且在此版本中，查询工具不会将结果写入磁盘。工具的使用由具备资质的专业人士负责，并须遵守 LGPD（第 13.709/2018 号法律）、CNJ 第 647/2025 号决议和 OAB 第 001/2024 号建议。这些工具不构成法律咨询。

---

参与贡献

欢迎贡献！

# 1. Clone o repositório ou seu fork
git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil

# 2. Instale as dependências de desenvolvimento
uv sync

# 3. Crie sua branch
git checkout -b feature/meu-recurso

# 4. Implemente, teste e verifique
pytest
ruff check src/
mypy src/

# 5. Abra um Pull Request

查看未解决的问题——尤其是标有 good first issue 的问题。

每个模块都遵循 client.py + schemas.py + tools.py 模式，因此可以轻松添加新的诉讼模块。

---

关联项目

此服务与 MCP Fiscal Brasil 配套，可将 AI 接入巴西税务系统（NF-e、SPED、CNPJ、Simples Nacional、2026 年税制改革）：

github.com/DeHor-Labs/mcp-fiscal-brasil

---

许可证

MIT——详情请参阅 LICENSE。

---

倾力献给巴西司法机构
_{将人工智能连接至国家司法体系的各级法院}