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つを選択）
# オプション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. Pull Requestを作成します。

📄 ライセンス

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

🔗 有用なリンク

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

📞 サポート

• 問題の報告: GitHub Issues
• ディスカッション: GitHub Discussions
• メール: seu-email@exemplo.com

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