Content
# MCP PJe-TJPI — 2º Grau
Servidor [MCP](https://modelcontextprotocol.io) para **consultar** o PJe do
Tribunal de Justiça do Piauí — **2º grau** (câmaras, acórdãos, recursos) — a
partir do Claude Desktop. É o espelho do projeto de 1º grau (`mcp-pje-tjpi-1g`),
apontando para `https://pje.tjpi.jus.br/2g`.
## ⚠️ Somente leitura
Este MCP **não peticiona, não protocola, não assina e não junta** nada no PJe.
As únicas escritas que faz são **em disco local** (download de autos/documentos
e rascunhos de petição `.docx` na pasta do processo). Além disso, há uma **trava
na camada de rede** (`PJeClient._guarda_somente_leitura`) que aborta qualquer
requisição a endpoint de peticionamento/assinatura/juntada — defesa adicional
contra mudanças futuras.
## Funcionalidades (22 tools)
- **Consulta:** processo por CNJ, últimas movimentações, relatório completo,
expedientes pendentes, prazos urgentes.
- **Buscas:** por nome de parte/advogado, CPF, CNPJ, OAB.
- **Documentos:** listar, ler teor (HTML/PDF), última decisão (inclui acórdão),
último despacho.
- **Download:** documento avulso, autos completos, preparação para análise.
- **Minutas (local):** salvar petição/relatório `.docx` na pasta do processo.
## Stack
Python 3.12 · [Playwright](https://playwright.dev) (Chromium) · FastMCP ·
pdfplumber · pyotp · keyring. Login no PJe via Keycloak (CPF + senha + TOTP 2FA).
## Instalação
```bash
python -m venv venv
venv\Scripts\activate # Windows
pip install -r requirements.txt
playwright install chromium
python setup_credenciais.py # salva CPF/senha/seed TOTP no cofre do SO
```
Registre no `claude_desktop_config.json`:
```json
"pje-tjpi-2g": {
"command": "C:\\caminho\\para\\venv\\Scripts\\python.exe",
"args": ["C:\\caminho\\para\\mcp-pje-tjpi-2g\\src\\server.py"]
}
```
## Segurança
- Credenciais ficam no **cofre nativo do SO** (Windows Credential Manager /
macOS Keychain) via `keyring` — **nunca** em arquivo neste repositório.
- Dados de processos (autos, documentos, minutas) são salvos localmente e
estão no `.gitignore` — não vão para o repositório.
