Pje MCP Server

🚀 🔐 PJE MCP Server

ブラジルのPJE（電子司法手続き）システムとの統合を目的としたMCP（モデルコンテキストプロトコル）サーバーです。デジタル証明書A1およびA3を完全にサポートしています。

✨ 主な機能

• ✅ PJEとの完全統合 - PJEのAPIに完全にアクセス可能
• 🔐 デジタル証明書 - A1（ファイル）およびA3（トークン/スマートカード）をサポート
• 📋 手続き管理 - 手続きの一覧表示、検索、追跡が可能
• 🏛️ 司法データ - 裁判所、訴訟種別、事件内容に関する情報を提供
• 🔍 高度なフィルタリング - 複数の条件での検索が可能
• 🌐 複数裁判所対応 - 任意のPJE対応裁判所で動作
• 🤖 Claude Desktop - AIとのネイティブ統合

📦 インストール

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 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"]
    }
  }
}

💻 使用例

基本的な使用法

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

🔐 デジタル証明書

証明書の特定 (Windows)

certutil -store My

サポートされる証明書の種類

承認された認証局

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

🏛️ テスト済みの裁判所

• TJCE - セアラ州司法裁判所
• TRF5 - 第5地区連邦裁判所
• 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 Desktopを完全に再起動します。
• claude_desktop_config.jsonのパスを確認します。

エラー: "Autenticação falhou"

• 証明書の有効期限を確認します。
• 裁判所のURLを確認します。
• 別の証明書でテストします。

🤝 コントリビューション

1. プロジェクトをForkします。
2. 新しい機能ブランチを作成します (git checkout -b feature/NovaFuncionalidade)。
3. 変更をコミットします (git commit -m 'Add: Nova funcionalidade')。
4. ブランチにPushします (git push origin feature/NovaFuncionalidade)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

🔗 有用なリンク

• MCPのドキュメント
• Claude Desktop
• PJEのドキュメント

📞 サポート

• 問題報告: GitHub Issues
• 議論: GitHub Discussions
• メール: seu-email@exemplo.com

このプロジェクトはブラジルの司法コミュニティに愛情を込めて開発されています。