Pje MCP Server

🚀 🔐 PJE MCP 服务器

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

🚀 快速开始

该服务器具备以下特性，能助力你高效集成 PJE 系统：

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

✨ 主要特性

• 全面集成 PJE：能够完全访问 PJE 的 API，实现与巴西电子司法流程系统的无缝对接。
• 数字证书支持：提供 A1（文件形式）和 A3（令牌/智能卡形式）数字证书的支持，保障系统的安全性和合法性。
• 流程管理功能：支持列出、搜索和跟踪司法流程，方便用户对案件进行管理。
• 司法数据获取：可获取审判机构、案件类别和主题等司法相关数据，为用户提供全面的信息支持。
• 高级筛选搜索：具备多条件搜索功能，使用户能够更精准地查找所需信息。
• 多法院兼容性：适用于任何 PJE 法院系统，具有广泛的适用性。
• AI 集成能力：与 Claude Desktop 进行原生集成，引入人工智能技术提升用户体验。

📦 安装指南

快速安装步骤

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

💻 使用示例

与 Claude 配合使用

在完成配置后，重启 Claude Desktop 即可使用自然语言命令，例如：

"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?"

📚 详细文档

配置说明

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 Desktop（Windows）配置

在 %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）配置

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

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

数字证书说明

识别证书（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
# 将正确的指纹复制到 .env 文件中

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

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

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

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

🔧 技术细节

项目结构

项目采用了清晰的结构，便于开发和维护：

• 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：清理编译生成的文件，保持项目的整洁。

🤝 贡献指南

如果你想为这个项目做出贡献，可以按照以下步骤进行：

1. Fork 项目：在 GitHub 上 Fork 该项目到自己的仓库。
2. 创建功能分支：使用 git checkout -b feature/NovaFuncionalidade 创建新的功能分支。
3. 提交更改：使用 git commit -m 'Add: Nova funcionalidade' 提交你的更改。
4. 推送分支：使用 git push origin feature/NovaFuncionalidade 将分支推送到你的仓库。
5. 发起 Pull Request：在 GitHub 上发起 Pull Request，等待审核和合并。

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

🔗 有用链接

• MCP 文档
• Claude Desktop
• PJE 文档

📞 支持渠道

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions
• 邮件联系：seu-email@exemplo.com

本项目由开发者怀着对巴西司法界的热爱精心打造。