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

本項目由 ❤️ 為巴西司法界社區開發。