内容
<!-- mcp-name: io.github.DeHor-Labs/mcp-juridico-brasil -->
<p align="center">
<img src="https://raw.githubusercontent.com/DeHor-Labs/mcp-juridico-brasil/main/assets/banner.svg" width="800" alt="MCP 法规巴西">
</p>
<p align="center">
<strong>连接任意一个 AI 助手到 DataJud CNJ 和 91 个巴西法院 - 具备计算时限、监控流程和 CPC 合规性。</strong>
</p>
<p align="center">
<a href="https://pypi.org/project/mcp-juridico-brasil/"><img src="https://img.shields.io/pypi/v/mcp-juridico-brasil?color=003087&label=PyPI" alt="PyPI 版本"></a>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10%2B-1a7a4a?logo=python&logoColor=white" alt="Python 3.10+"></a>
<a href="https://github.com/DeHor-Labs/mcp-juridico-brasil/actions/workflows/ci.yml"><img src="https://github.com/DeHor-Labs/mcp-juridico-brasil/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/licenca-MIT-4fc3f7?labelColor=001f5b" alt="MIT 许可"></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatível-7c3aed" alt="MCP 兼容"></a>
<img src="https://img.shields.io/github/stars/DeHor-Labs/mcp-juridico-brasil?style=flat&color=003087" alt="星星">
<img src="https://img.shields.io/github/issues/DeHor-Labs/mcp-juridico-brasil?color=4fc3f7&labelColor=001f5b" alt="问题">
</p>
<p align="center">
<a href="#什么是">什么是</a> ·
<a href="#可用工具">工具</a> ·
<a href="#安装">安装</a> ·
<a href="#MCP客户端配置">配置</a> ·
<a href="#路线图">路线图</a> ·
<a href="#贡献">贡献</a>
</p>
---
## 什么是
`mcp-juridico-brasil` 将 AI 助手、律师事务所和司法管理系统连接到 **DataJud CNJ** - 国家司法委员会的统一司法数据基础 - 覆盖 **91 个巴西法院**，适用于所有司法机构（联邦、州、劳动、军事、选举和高等法院）。
该服务器不是一个通用的公共数据目录。提议是成为一个垂直流程：将分散的司法查询转化为 **安全、可组合、适用于代理的工具** - 按照 CPC 计算工作日时限、监控流程动态和持久快照。
---
## 可用工具
第一阶段和第二阶段的工具，现已可立即使用。
### 流程查询和监控
| 工具 | 描述 | 来源 |
| --- | --- | --- |
| `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 条）计算工作日时限 | 离线 |
### 法院参考
| 工具 | 描述 | 来源 |
| --- | --- | --- |
| `listar_tribunais` | 列出所有 91 个受支持的缩写（CNJ 第 160/2020 号令） | 离线 |
### MCP 资源
| 资源 | 描述 |
| --- | --- |
| `processo://{numero}/snapshot` | 受监控流程的最新快照 |
---
## 安装
最简单的方法，不需要永久安装任何东西：
```bash
uvx mcp-juridico-brasil
```
> **什么是 `uvx`？** 这是 [uv](https://docs.astral.sh/uv/) 的工具管理器，它在隔离环境中下载并执行 Python 包，而不会污染您的系统。如果您还没有 uv，请执行：`curl -LsSf https://astral.sh/uv/install.sh | sh`
> **保持更新：** 使用 `uvx mcp-juridico-brasil@latest` 或 `uvx --refresh mcp-juridico-brasil` 强制使用 PyPI 的最新版本。
### 永久安装（替代方案）
```bash
# 通过 pip
pip install mcp-juridico-brasil
# 通过 uv（推荐用于 Python 项目）
uv add mcp-juridico-brasil
```
### 从源代码开始
```bash
git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil
uv sync
```
---
## MCP 客户端配置
将以下内容粘贴到您的客户端配置文件中。`DATAJUD_API_KEY` 变量对于 DataJud CNJ 查询是必需的 - 请在 [datajud-wiki.cnj.jus.br](https://datajud-wiki.cnj.jus.br/api-publica/acesso/) 上请求。
### 克劳德桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"juridico-brasil": {
"command": "uvx",
"args": ["mcp-juridico-brasil"],
"env": {
"DATAJUD_API_KEY": "您的密钥在此"
}
}
}
}
```
重启克劳德桌面版。司法工具会自动出现。
### 克劳德代码（CLI）
```bash
claude mcp add juridico-brasil -- uvx mcp-juridico-brasil
```
要包含 API 密钥：
```bash
DATAJUD_API_KEY=您的密钥在此 claude mcp add juridico-brasil -- uvx mcp-juridico-brasil
```
### 光标 / `.mcp.json`
创建或编辑 `.cursor/mcp.json`（或项目根目录下的 `.mcp.json`）：
```json
{
"mcpServers": {
"juridico-brasil": {
"command": "uvx",
"args": ["mcp-juridico-brasil"],
"env": {
"DATAJUD_API_KEY": "您的密钥在此"
}
}
}
}
```
### VS Code + 继续
添加到 `settings.json`：
```json
{
"continue.mcpServers": {
"juridico-brasil": {
"command": "uvx",
"args": ["mcp-juridico-brasil"],
"env": {
"DATAJUD_API_KEY": "您的密钥在此"
}
}
}
}
```
---
## 环境变量
| 变量 | 描述 | 默认值 |
| --- | --- | --- |
| `DATAJUD_API_KEY` | DataJud CNJ 访问密钥（查询所需） | - |
| `MCP_JURIDICO_LOG_LEVEL` | 日志级别：`DEBUG`、`INFO`、`WARNING` | `INFO` |
| `JURIDICO_SNAPSHOT_DIR` | 文件快照持久化目录（可选） | 内存 |
| `HTTP_TIMEOUT` | DataJud HTTP 调用超时（秒） | `30` |
---
## 架构
```
克劳德 / GPT / 光标 / 任意 MCP 客户端
|
| 模型上下文协议（标准输入/输出）
v
mcp-juridico-brasil
|
+---------+---------+-----------+----------+
| | | | |
流程 动态 摘要 监控 时限
| | | | |
v v v v v
DataJud DataJud DataJud 快照 司法日历
CNJ CNJ CNJ 内存/磁盘 离线
|
|
v
91 个法院
（联邦、州、劳工、军事、选举和高等法院）
```
**数据源：**
- [DataJud CNJ](https://datajud-wiki.cnj.jus.br/) - 统一司法数据基础（CNJ 第 160/2020 号令）
- 国家和州司法日历 - 离线处理以计算时限（CPC 第 219/220/224 条）
---
## 路線图
- [x] **v0.1.x** - 流程查询、动态列表、进度摘要和法院列表
- [x] **v0.2.x** - 带有快照的监控、工作日时限计算（CPC）、按流程的 MCP 资源
- [ ] **v0.3.x** - 更新推送 Webhook、数据库持久性和时限警报
- [ ] **v0.4.x** - 通过电子司法居所（DJe）进行通知、发布解析和结构化提取
- [ ] **v1.0.0** - 具备 LGPD 审计、稳定 API 合同和扩展覆盖的完整司法套件
---
## 隐私和 LGPD
> **注意：** `mcp-juridico-brasil` 独家访问由 DataJud CNJ（CNJ 第 330/2020 号决议）提供的公共数据。**保密司法** 流程不会被 API 返回，也不会被此服务器访问。除非明确配置 `JURIDICO_SNAPSHOT_DIR`，否则不会在用户本地环境之外存储任何流程数据。使用这些工具的责任由合格的专业人员根据 LGPD（第 13.709/2018 号法律）、CNJ 第 647/2025 号决议和 OAB 推荐 001/2024 号文件承担。这些工具不构成法律咨询。
---
## 贡献
欢迎贡献！
```bash
# 1. 克隆仓库或您的复刻
git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil
# 2. 安装开发依赖项
uv sync
# 3. 创建您的分支
git checkout -b feature/我的资源
# 4. 实现、测试和验证
pytest
ruff check src/
mypy src/
# 5. 打开拉取请求
```
查看 [开放问题](https://github.com/DeHor-Labs/mcp-juridico-brasil/issues) - 特别是标记为 `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](https://github.com/DeHor-Labs/mcp-fiscal-brasil)
---
## 许可
MIT - 请参阅 [LICENSE](LICENSE) 获取详细信息。
---
<p align="center">
致力于巴西司法系统
<br>
<sub>连接人工智能与国家司法系统的 91 个法院</sub>
</p>
