Pje MCP Server

🚀 PJE MCP Server

This is an MCP (Model Context Protocol) server for integration with the Brazilian PJE (Electronic Judicial Process) system, fully supporting A1 and A3 digital certificates.

✨ Features

• ✅ Full PJE Integration - Full access to the PJE API.
• 🔐 Digital Certificates - Support for A1 (file) and A3 (token/smartcard).
• 📋 Process Management - List, search, and track judicial processes.
• 🏛️ Judicial Data - Information on judicial bodies, case types, and subjects.
• 🔍 Advanced Filters - Search with multiple criteria.
• 🌐 Multi - Tribunal Support - Works with any PJE - enabled tribunal.
• 🤖 Claude Desktop Integration - Native integration with AI.

📦 Installation

git clone https://github.com/seu-usuario/pje-mcp-server.git
cd pje-mcp-server
npm install
cp .env.example .env
# Edit the .env file with your configurations
npm run build

⚙️ Configuration

1. Basic Configuration (.env)

# URL of your tribunal
PJE_BASE_URL=https://pje.tjce.jus.br
PJE_APP_NAME=pje-tjce-1g

# Digital Certificate (choose one option)
# Option 1: PFX File
PJE_CERTIFICATE_PFX_PATH=C:\certificado.pfx
PJE_CERTIFICATE_PFX_PASSWORD=senha123

# Option 2: Windows Store
PJE_CERTIFICATE_THUMBPRINT=abc123...

2. Claude Desktop (Windows)

Add the following to the file %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["C:\\caminho\\para\\pje-mcp-server\\build\\index.js"]
    }
  }
}

3. Claude Desktop (Mac/Linux)

Add the following to the file ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["/caminho/para/pje-mcp-server/build/index.js"]
    }
  }
}

💻 Usage with Claude

After configuration, restart Claude Desktop and use natural language commands:

"Configure the PJE of TJCE"
"List my processes"
"Search for process 1234567 - 89.2024.8.06.0001"
"Show the judicial bodies"
"What are my hearings this week?"

🔐 Digital Certificates

Identify Your Certificate (Windows)

certutil -store My

Supported Types

Approved Certification Authorities

• SERPRO
• Certisign
• Serasa Experian
• Valid
• Soluti
• AC Caixa

🏛️ Tested Tribunals

• TJCE - Court of Justice of Ceará
• TRF5 - 5th Regional Federal Court
• TJMG - Court of Justice of Minas Gerais
• TJSP - Court of Justice of São Paulo
• TJRJ - Court of Justice of Rio de Janeiro

📝 Available Commands

Configuration

• pje_configurar - Configure the connection to the tribunal.
• pje_configurar_certificado - Configure the digital certificate.
• pje_listar_certificados - List installed certificates.
• pje_info_certificado - Information about the current certificate.
• pje_status - Configuration status.

Queries

• pje_listar_processos - List processes with filters.
• pje_buscar_processo - Search for a process by number.
• pje_listar_orgaos_julgadores - List judicial bodies.
• pje_listar_classes - List case types.
• pje_listar_assuntos - List available subjects.

🛠️ Development

Project Structure

pje-mcp-server/
├── src/                    # TypeScript source code
│   ├── index.ts           # Main server
│   ├── certificate-manager.ts  # Certificate management
│   └── types.ts           # Types and interfaces
├── build/                 # Compiled code (generated)
├── docs/                  # Additional documentation
├── examples/              # Configuration examples
└── package.json          # Project configuration

Available Scripts

npm run build    # Compile TypeScript
npm run start    # Start the server
npm run dev      # Compile and start
npm run clean    # Clean compiled files

🐛 Troubleshooting

Error: "Certificate not found"

# List available certificates
certutil -store My
# Copy the correct thumbprint to .env

Error: "Command not found"

• Restart Claude Desktop completely.
• Check the path in claude_desktop_config.json.

Error: "Authentication failed"

• Check the validity of the certificate.
• Confirm the tribunal's URL.
• Test with another certificate.

🤝 Contributing

1. Fork the project.
2. Create your Feature Branch (git checkout -b feature/NewFunctionality).
3. Commit your changes (git commit -m 'Add: New functionality').
4. Push to the Branch (git push origin feature/NewFunctionality).
5. Open a Pull Request.

📄 License

This project is under the MIT license. See the LICENSE file for more details.

🔗 Useful Links

• MCP Documentation
• Claude Desktop
• PJE Documentation

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: seu-email@exemplo.com

Developed with ❤️ for the Brazilian legal community.