MCP Juridico Brasil

あらゆる AI アシスタントを DataJud CNJ に接続します。92 の裁判所略称を登録済みで、期限の計算、訴訟案件のモニタリング、CPC への準拠に対応しています。

juridico.dehor.dev：プロジェクトのページです。使用例、インストール方法、よくある質問を掲載しています。

概要 · 利用可能なツール · インストール · 設定 · ロードマップ · 貢献

---

概要

mcp-juridico-brasil は、AI アシスタント、法律事務所、訴訟管理システムを DataJud CNJ（国家司法評議会の統合司法データベース）に接続します。あらゆる司法分野（連邦、州、労働、軍事、選挙、高等裁判所）の92 の裁判所略称を登録済みです。登録されていても、DataJud にその裁判所のデータがあるとは限りません。データ量は、各裁判所が CNJ に送信する内容によって異なります。

このサーバーは、汎用的な公開データのカタログではありません。訴訟手続きに特化した領域を目指し、断片化された司法検索を、安全で組み合わせ可能な、エージェントですぐに利用できるツールへと変換します。CPC に準拠した営業日ベースの期限計算、検索による手続き状況のモニタリング、電子司法住所へのアクセスを提供します。

---

利用可能なツール

サーバーには9 個のツールと1 個のリソースが登録されています（src/mcp_juridico_brasil/server.py を参照）。

訴訟案件の検索とモニタリング

ツール	説明	データソース
buscar_processo_por_numero	CNJ 番号（NNNNNNN-DD.AAAA.J.TT.OOOO）による訴訟案件の詳細検索	DataJud CNJ
listar_movimentacoes	日付で絞り込める、訴訟手続きの経過履歴	DataJud CNJ
resumir_andamento	訴訟案件のデータと、言語モデル向けの要約指示	DataJud CNJ
monitorar_processo	指定日以降に更新があったかどうかと、最終更新日を通知します（ポーリング。スナップショットは保存しません）	DataJud CNJ
listar_processos_monitorados	セッションにスナップショットが保存された訴訟案件を一覧表示します。このバージョンでは検索ツールがスナップショットを保存しないため、一覧は空になります	ローカルメモリ

訴訟期限の計算

ツール	説明	参照
calcular_proximo_prazo	法廷休廷期間と国民の祝日を考慮した営業日ベースの期限計算（CPC 第 219 条、第 220 条、第 224 条）。uf が指定された場合に限り、州の祝日も含めます	data_intimacao_iso がある場合はオフラインで計算します。指定がない場合は、最終更新を利用するため DataJud を参照します

裁判所の参照

ツール	説明	データソース
listar_tribunais	サーバーに登録されている92の略称を一覧表示します（CNJ規則160/2020）	オフライン

電子司法上の住所（任意）

DJe専用の認証情報（DJE_CLIENT_ID、DJE_CLIENT_SECRET、DJE_BEHALF_OF_CPF）が必要です。

ツール	説明	データソース
listar_intimacoes	DJeで受信した通知を一覧表示します。読み取り専用です。機密扱いの通知の内容は省略されます	DJe（API Comunica）
confirmar_leitura_intimacao	通知の既読を確定します。実際の法的効力があり、期限の起算が始まります。 デフォルトではドライランで動作し、confirmar=TrueかつDJE_PERMITIR_CONFIRMACAO_LEITURA=trueの場合にのみ確定します	DJe（API Comunica）

MCPリソース

リソース	説明
processo://{numero}/snapshot	保存済みのプロセスのスナップショットがあれば読み込みます。buscar_processo_por_numeroとmonitorar_processoはスナップショットを保存しないため、このバージョンではスナップショットが利用できない旨が返されます

---

インストール

何も恒久的にインストールしない、最も簡単な方法です。

uvx mcp-juridico-brasil

uvxとは？ uvのツールマネージャーで、Pythonパッケージを隔離された環境にダウンロードして実行し、システムを汚しません。uvをまだお持ちでない場合：curl -LsSf https://astral.sh/uv/install.sh | sh

最新の状態を保つには： uvx mcp-juridico-brasil@latestまたはuvx --refresh mcp-juridico-brasilを使うと、PyPIの最新バージョンを強制的に取得できます。

恒久的なインストール（代替方法）

# via pip
pip install mcp-juridico-brasil

# via uv (recomendado para projetos Python)
uv add mcp-juridico-brasil

ソースコードからのインストール

git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil
uv sync

---

MCPクライアントごとの設定

以下のスニペットをクライアントの設定ファイルに貼り付けてください。DATAJUD_API_KEY変数は任意です。デフォルトでは、サーバーはdatajud-wiki.cnj.jus.brでCNJが公開している現在有効な公開キーを使用します。CNJはいつでもキーを変更する可能性があるため、必要に応じてこの変数を使って置き換えてください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

Claude Desktopを再起動してください。法律関連のツールが自動的に表示されます。

Claude Code（CLI）

claude mcp add juridico-brasil -- uvx mcp-juridico-brasil

APIキーを追加するには：

DATAJUD_API_KEY=sua-chave-aqui claude mcp add juridico-brasil -- uvx mcp-juridico-brasil

Cursor / .mcp.json

.cursor/mcp.json（またはプロジェクトのルートにある.mcp.json）を作成または編集します。

{
  "mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

VS Code + Continue

settings.jsonに追加します。

{
  "continue.mcpServers": {
    "juridico-brasil": {
      "command": "uvx",
      "args": ["mcp-juridico-brasil"],
      "env": {
        "DATAJUD_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

---

環境変数

変数	説明	デフォルト
DATAJUD_API_KEY	DataJud CNJのデフォルト公開キーを置き換えます	CNJの現在有効な公開キー
JURIDICO_LOG_LEVEL	ログレベル：DEBUG、INFO、WARNING	INFO
JURIDICO_SNAPSHOT_DIR	保存済みスナップショットをファイルに永続化するディレクトリ。このバージョンでは照会ツールはスナップショットを保存しません	メモリ
JURIDICO_HTTP_TIMEOUT	DataJudへのHTTP呼び出しのタイムアウト（秒）	30

---

アーキテクチャ

Claude / GPT / Cursor / qualquer cliente MCP
              |
              | Model Context Protocol (stdio)
              v
    mcp-juridico-brasil
              |
    +---------+---------+-----------+----------+
    |         |         |           |          |
 Processos  Movim.   Resumo    Monitoram.  Prazos
    |         |         |           |          |
    v         v         v           v          v
 DataJud   DataJud   DataJud    DataJud   Calendario
  CNJ        CNJ       CNJ        CNJ      forense
                                           offline
              |
              v
   92 siglas de tribunais
  (Federal, Estadual, Trabalho,
   Militar, Eleitoral, Superior)

データソース：

• DataJud CNJ - 統合司法データベース（CNJ規則160/2020）
• 全国および州の司法カレンダー - 期限計算用にオフラインで処理（CPC第219条／第220条／第224条）

---

ロードマップ

• v0.1.x - プロセスの検索、処理状況の一覧表示、進捗の要約、裁判所の一覧表示
• v0.2.x - 照会による監視、営業日単位の期限計算（CPC）、プロセスごとのMCPリソース
• v0.3.x - 更新を通知するWebhookプッシュ、データベースへの永続化、期限アラート
• v0.4.x（一部対応） - 電子司法上の住所（DJe）経由の通知：既読の一覧表示と二重ゲートによる確定
• v0.4.x - 公告の解析と構造化データの抽出
• v1.0.0 - LGPD監査、安定したAPI契約、対象範囲の拡大を備えた完全な訴訟管理スイート

---

プライバシーとLGPD

注意： 訴訟情報を照会するツールがアクセスするのは、DataJud CNJ が公開している公開データのみです（CNJ 決議 331/2020）。司法上の秘密扱いとなっている事件は、この API から返されません。オプションの DJe ツールは異なります。弁護士本人の認証情報を使用して、電子司法住所で受信した非公開の訴訟関連通知にアクセスしますが、機密扱いの通知の内容は表示されません。また、confirmar_leitura_intimacao は法的効力を生じさせる可能性があります。訴訟データはユーザーのローカル環境外には保存されません。また、このバージョンでは照会ツールの結果がディスクに保存されることはありません。ツールの利用は、LGPD（法律 13.709/2018）、CNJ 決議 647/2025、および OAB 勧告 001/2024 に従い、資格を有する専門家の責任のもとで行ってください。これらのツールは法律相談を提供するものではありません。

---

貢献

貢献を歓迎します！

# 1. Clone o repositório ou seu fork
git clone https://github.com/DeHor-Labs/mcp-juridico-brasil.git
cd mcp-juridico-brasil

# 2. Instale as dependências de desenvolvimento
uv sync

# 3. Crie sua branch
git checkout -b feature/meu-recurso

# 4. Implemente, teste e verifique
pytest
ruff check src/
mypy src/

# 5. Abra um Pull Request

オープン中の issueをご覧ください。特に good first issue のラベルが付いたものを歓迎します。

各モジュールは client.py + schemas.py + tools.py のパターンに従っているため、新しい訴訟関連モジュールを簡単に追加できます。

---

関連プロジェクト

このサーバーは、ブラジルの税務システム（NF-e、SPED、CNPJ、Simples Nacional、2026 年税制改革）に AI を接続する MCP Fiscal Brasil と対をなしています。

github.com/DeHor-Labs/mcp-fiscal-brasil

---

ライセンス

MIT — 詳細は LICENSE をご覧ください。

---

ブラジルの司法のために心を込めて作成
_{人工知能と国内司法制度の裁判所をつなぎます}