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

本項目由開發者懷著對巴西司法界的熱愛精心打造。