此 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-导航到URLbrowser_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📚 附加文档
🔒 安全
- ✅ 从不 提交证书或密码
- ✅ 安全目录中的证书 （
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 -nodesPlaywright 未找到
# 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