使用说明

此 PJE MCP 服务器

完整的 MCP 服务器，用于与圣灵法院电子司法程序（PJE）集成

📋 概览

这个项目提供 3台集成的MCP服务器 全面访问TJES司法系统：

1.🌐 剧作家MCP（微软官方）

Web 自动化和 Scraping
TJES 判例界面
使用 A1 证书进行基于浏览器的身份验证
下载PDF和文档

2 。🔐 TJES PJE MCP 服务器 (自定义 - Python)

8 个经过认证的 MCP 工具
支持 A1 和 A3 数字证书
PJE API（1级和2级）
完整的流程管理

3.📊 DataJud MCP服务器（自定义-Python）

5 公共 MCP 工具
DataJud 公共 API （CNJ）
无复杂身份验证查询
统计和汇总

🎯 主要特点

✅ 强大的身份验证 A1/A3数字证书
✅ 13+ MCP工具 专业的
✅ 多服务器架构 奥替米扎达
✅ 剧作家整合 用于刮削和自动化
✅ 重试逻辑 和错误处理
✅ 结构化日志 和监测
✅ 完整文档 com前任

🚀 快速开始

先决条件

Python 3.10+
Node.js 18+（准剧作家）
A1或A3数字证书（用于经过认证的PJE）
克劳德桌面

安装

# 1. Clone o repositório
cd /mnt/c/Projetos2/mcp_pje

# 2. Instale dependências Python
pip install -r datajud_mcp/requirements.txt
pip install -r tjes_pje_mcp/requirements.txt

# 3. Configure variáveis de ambiente
cp .env.example .env
# Edite .env com suas credenciais

# 4. Configure Claude Desktop
# Copie o conteúdo de claude_desktop_config.json para:
# ~/.config/Claude/claude_desktop_config.json (Linux)
# ou
# %APPDATA%\Claude\claude_desktop_config.json (Windows)

# 5. Reinicie Claude Desktop

快速设置

编辑文件 .env:

# DataJud (API Pública)
DATAJUD_API_KEY="cDZHYzlZa0JadVREZDJCendQbXY6SkJlTzNjLV9TRENyQk1RdnFKZGRQdw=="

# TJES PJE (Certificado A1)
PJE_CERT_TYPE="A1"
PJE_CERT_PATH="/home/seu_usuario/.certificates/tjes_pje.pfx"
PJE_CERT_PASSWORD="sua_senha_certificado"

🔧 可用工具

DataJud MCP （公共 - 5 个工具）

工具	描述
`datajud_query_process` 查询CNJ号码
`datajud_search_by_class` 按程序类搜索
`datajud_search_by_date_range`	按期间搜索
`datajud_advanced_search` 查询 Elasticsearch 自定义
`datajud_get_statistics` 按期统计。

TJES PJE MCP （已验证 - 8 个工具）

工具	描述
`pje_certificate_status`	数字证书状态
`pje_search_process` 查找进程（已验证）
`pje_list_processes` 列出有过滤器的过程
`pje_get_movements` 过程的动作。
`pje_list_documents` 过程文件
`pje_list_classes` 程序类
`pje_list_organs` 审判机构。
`pje_list_subjects` 程序事项

Playwright MCP（网络自动化）

browser_navigate -导航到URL
browser_snapshot - 捕捉页面状态
browser_click 点击元素
browser_fill_form - 填写表格
browser_take_screenshot -截图
更多 20+ Web 自动化工具

📖 使用范例

查询进程（ DataJud - 公共）

Use a ferramenta datajud_query_process com:
- numero_processo: "0000166-19.2023.8.08.0035"

按类搜索进程（PJE - 认证）

Use a ferramenta pje_list_processes com:
- classe: "1234"
- orgao_julgador: "5678"
- limit: 20
- grau: "1"

废法律（剧作家）

1. browser_navigate para: https://sistemas.tjes.jus.br/consulta-jurisprudencia/
2. browser_fill_form com os critérios de busca
3. browser_click no botão "Pesquisar"
4. browser_snapshot para capturar resultados

校验证书

Use a ferramenta pje_certificate_status

🏗️ 建筑

┌─────────────────────────────────────┐
│      Claude Desktop (Host)          │
│  ┌───────────────────────────────┐ │
│  │   MCP Client Manager          │ │
│  └───────────┬───────────────────┘ │
└──────────────┼──────────────────────┘
               │
       ┌───────┼───────┐
       │       │       │
       ▼       ▼       ▼
    ┌────┐ ┌────┐ ┌────┐
    │Play│ │PJE │ │Data│
    │wrgh│ │    │ │Jud │
    └────┘ └────┘ └────┘

📁 项目结构

mcp_pje/
├── datajud_mcp/              # Servidor DataJud
│   ├── server.py             # Servidor principal
│   ├── requirements.txt      # Dependências
│   └── README.md             # Documentação
├── tjes_pje_mcp/             # Servidor TJES PJE
│   ├── server.py             # Servidor principal
│   ├── cert_manager.py       # Gerenciador de certificados
│   ├── requirements.txt      # Dependências
│   └── README.md             # Documentação
├── tests/                    # Testes
│   ├── test_datajud.py
│   ├── test_tjes_pje.py
│   └── test_integration.py
├── docs/                     # Documentação adicional
├── .gitignore                # Arquivos ignorados
├── .env.example              # Exemplo de configuração
├── claude_desktop_config.json # Configuração Claude Desktop
├── LICENSE                   # Licença MIT
└── README.md                 # Este arquivo

🔐 数字证书

A1 证书（PFX 文件）

# 1. Coloque seu certificado em local seguro
mkdir -p ~/.certificates
chmod 700 ~/.certificates
cp seu_certificado.pfx ~/.certificates/tjes_pje.pfx
chmod 600 ~/.certificates/tjes_pje.pfx

# 2. Configure no .env
PJE_CERT_TYPE="A1"
PJE_CERT_PATH="$HOME/.certificates/tjes_pje.pfx"
PJE_CERT_PASSWORD="sua_senha"

A3证书（智能卡/代币）

⚠️ 有限的 httpx 支持对于A3，请考虑：

导出临时 A1 证书
使用基于浏览器的身份验证 Playwright
设置 Windows 证书存储（仅限 Windows）

🧪 睾丸

# Testar DataJud (não requer certificado)
python tests/test_datajud.py

# Testar TJES PJE (requer certificado)
python tests/test_tjes_pje.py

# Testar integração completa
python tests/test_integration.py

📚 附加文档

安装详情 - 一步一步的指南
使用范例 50+实例
证书 A1/A3证书指南
建筑 - 技术细节
剧作家整合 Web 自动化

🔒 安全

✅ 从不提交证书或密码
✅ 安全目录中的证书（chmod 600)
✅ 通过环境变量密码
✅ .gitignore 设置为安全
✅ 日志不显示凭据
✅ 证书校验
✅ 已验证的 HTTPS 连接

🐛 故障排除

错误 : “ 找不到证书 ”

# Verificar caminho do certificado
ls -la ~/.certificates/tjes_pje.pfx

# Verificar permissões
chmod 600 ~/.certificates/tjes_pje.pfx

错误 : “ 密码不正确 ”

# Testar certificado com openssl
openssl pkcs12 -info -in ~/.certificates/tjes_pje.pfx -nodes

Playwright 未找到

# Instalar Playwright
npx -y @playwright/mcp@latest

# Verificar Node.js
node --version  # Deve ser 18+

🤝 贡献

欢迎捐款！请：

分叉工程
为您的功能创建一个分支（git checkout -b feature/AmazingFeature)
提交您的更改（git commit -m 'Add some AmazingFeature')
推动一个分支(git push origin feature/AmazingFeature)
Abra um Pull请求

📄 许可证

这个项目是根据麻省理工学院许可证授权的 - 查看文件许可证为了细节。

👤 作者

开发者 克劳德代码 与他们融合。

🔗 链接乌斯

📊 项目状态

✅ Datajud MCP服务器-完整
✅ TJES PJE MCP 服务器 - 完整
✅ 证书管理器-Completo
✅ 剧作家集成-配置
⏳ 详细文档 - 正在进行中
⏳ 自动化测试 - 正在进行中

🎯 路线图

[ ] 完整的自动化测试
[]CI/CD com GitHub操作
[]Docker容器
改进的A3支持
[ ] 分布式缓存
[ ] 通知的 Webhooks
[ ] 监控仪表板

备注本项目使用CNJ和TJES的公共和认证API。在生产之前，请确保获得适当的许可。

开发于❤️ 使用 Claude Code