Pje MCP Server

🚀 🔐 PJE MCP服务器

这是一个用于与巴西电子司法流程系统（PJE）集成的MCP（模型上下文协议）服务器，它完全支持A1和A3数字证书。

🚀 快速开始

该服务器能让你全面访问PJE系统，支持多种数字证书，还能进行司法流程管理等操作。以下是使用前的一些特性和安装步骤。

✨ 主要特性

• ✅ 与PJE完全集成 - 可全面访问PJE的API。
• 🔐 数字证书支持 - 支持A1（文件形式）和A3（令牌/智能卡形式）证书。
• 📋 流程管理 - 可列出、搜索和跟踪司法流程。
• 🏛️ 司法数据获取 - 能获取审判机关、案件类别和主题等信息。
• 🔍 高级筛选功能 - 支持多条件搜索。
• 🌐 多法院支持 - 可与任何PJE法院系统配合使用。
• 🤖 Claude桌面集成 - 与人工智能进行原生集成。

📦 安装指南

快速安装

git clone https://github.com/seu-usuario/pje-mcp-server.git
cd pje-mcp-server
npm install
cp .env.example .env
# 编辑.env文件，填入你的配置信息
npm run build

⚙️ 配置

1. 基本配置（.env文件）

# 你的法院系统URL
PJE_BASE_URL=https://pje.tjce.jus.br
PJE_APP_NAME=pje-tjce-1g

# 数字证书（选择一种方式）
# 选项1：PFX文件
PJE_CERTIFICATE_PFX_PATH=C:\certificado.pfx
PJE_CERTIFICATE_PFX_PASSWORD=senha123

# 选项2：Windows存储
PJE_CERTIFICATE_THUMBPRINT=abc123...

2. Claude桌面（Windows系统）

在 %APPDATA%\Claude\claude_desktop_config.json 文件中添加以下内容：

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

3. Claude桌面（Mac/Linux系统）

在 ~/.config/claude/claude_desktop_config.json 文件中添加以下内容：

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

💻 使用示例

基础用法

在完成配置后，重启Claude桌面，然后使用自然语言命令：

"Configure o PJE do TJCE"
"Liste meus processos"
"Busque o processo 1234567-89.2024.8.06.0001"
"Mostre os órgãos julgadores"
"Quais são minhas audiências esta semana?"

🔐 数字证书

识别你的证书（Windows系统）

certutil -store My

支持的证书类型

认证机构

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

🏛️ 测试过的法院系统

• TJCE - 塞阿拉州司法法院
• TRF5 - 第五地区联邦法院
• TJMG - 米纳斯吉拉斯州司法法院
• TJSP - 圣保罗州司法法院
• TJRJ - 里约热内卢州司法法院

📝 可用命令

配置命令

• pje_configurar - 配置与法院系统的连接。
• pje_configurar_certificado - 配置数字证书。
• pje_listar_certificados - 列出已安装的证书。
• pje_info_certificado - 显示当前证书的信息。
• pje_status - 显示配置状态。

查询命令

• pje_listar_processos - 列出带有筛选条件的司法流程。
• pje_buscar_processo - 根据编号搜索司法流程。
• pje_listar_orgaos_julgadores - 列出审判机关。
• pje_listar_classes - 列出诉讼类别。
• pje_listar_assuntos - 列出可用的主题。

🔧 技术细节

项目结构

pje-mcp-server/
├── src/                    # TypeScript源代码
│   ├── index.ts           # 主服务器文件
│   ├── certificate-manager.ts  # 证书管理文件
│   └── types.ts           # 类型和接口文件
├── build/                 # 编译后的代码（自动生成）
├── docs/                  # 额外的文档
├── examples/              # 配置示例
└── package.json          # 项目配置文件

可用脚本

npm run build    # 编译TypeScript代码
npm run start    # 启动服务器
npm run dev      # 编译并启动服务器
npm run clean    # 清理编译后的文件

🐛 问题解决

错误："Certificado não encontrado"（未找到证书）

# 列出可用的证书
certutil -store My
# 将正确的thumbprint复制到.env文件中

错误："Comando não encontrado"（未找到命令）

• 完全重启Claude桌面。
• 检查 claude_desktop_config.json 文件中的路径。

错误："Autenticação falhou"（认证失败）

• 检查证书的有效性。
• 确认法院系统的URL。
• 尝试使用其他证书。

🤝 贡献指南

1. Fork本项目。
2. 创建你的功能分支 (git checkout -b feature/NovaFuncionalidade)。
3. 提交你的更改 (git commit -m 'Add: Nova funcionalidade')。
4. 将更改推送到分支 (git push origin feature/NovaFuncionalidade)。
5. 打开一个Pull Request。

📄 许可证

本项目采用MIT许可证。更多详情请查看 LICENSE 文件。

🔗 有用链接

• MCP文档
• Claude桌面
• PJE文档

📞 支持渠道

• 问题反馈：GitHub Issues
• 讨论区：GitHub Discussions
• 邮箱：seu-email@exemplo.com

本项目由 ❤️ 为巴西司法界社区开发。