Brazilian Sanctions

Brazilian Sanctions MCP Server

Porta da Transparência API を通じて、ブラジルの制裁データベースにアクセスできる MCP（Model Context Protocol）サーバーです。

コンポーネント

• mcp_server.py - ブラジルの制裁情報を検索するツールを公開する MCP サーバー
• BrazillianSanctions.json - MCP 設定ファイル

特長

• ブラジルの5つの制裁登録簿を横断して検索
• API レスポンスから特定のフィールド（氏名、制裁機関、日付、所在地）を抽出
• 終了日をもとに制裁が現在も有効か確認
• すべての登録簿から最大限の情報を取得し、包括的な概要を提供
• AI チャットボットによるシンプルな自然言語インターフェース（テスト専用）
• CNPJ、CPF、または企業名で検索
• 理由、日付、機関など、制裁に関する詳細情報
• 安全な API キー認証
• 非同期実行に対応したツール

対応する制裁登録簿

登録簿	用途	検索対象
CNEP	国家処罰登録簿	CNPJ、CPF
CEPIM	制裁対象公務員登録簿	CNPJ、CPF
CEIS	資格停止事業体登録簿	CNPJ、CPF
CEAF	公務員資格停止登録簿	CPF
Leniency Agreements	司法取引記録	氏名、CNPJ

重要：氏名での検索は Leniency Agreements のみで利用できます。その他の登録簿（CNEP、CEIS、CEPIM、CEAF）は、API の制限により CNPJ／CPF での検索のみ対応しています。

API キーの設定

このシステムの利用には API キーが必須です。

API キーの取得方法：

1. 次のサイトにアクセスします：https://www.portaldatransparencia.gov.br/（ブラジルの CPF が必要です）
2. ログインするか、アカウントを作成します
3. 「Minha Conta」→「API Keys」または「Desenvolvedor」に移動します
4. 新しい API キーを生成します
5. キーをコピーします（形式：abcd1234efgh5678ijkl9012）

セットアップ：

プロジェクトのルートに .env ファイルを作成します：

PORTAL_TRANSPARENCIA_API_KEY=your_key_here

セキュリティ：API キーをバージョン管理にコミットしないでください！

使用方法

MCP サーバーの実行

MCP サーバーは単独で実行することも、MCP クライアントから利用することもできます：

python mcp_server.py

または

Claude／Cursor で使用するには、次を実行します

\BrazillianSanctions.json

クエリの例：

• 「30.477.220/0001-71 がブラジルから制裁を受けているか、受けている場合はその理由を知りたい」
• 「Leniency Agreements で Petrobras を検索する」
• 「CNPJ 11222333000181 の企業が制裁を受けているか確認する」

MCP サーバーのツール

MCP サーバーは次のツールを公開します：

検索ツール

• search_cnep - CNPJ、CPF、機関、または日付範囲で CNEP（国家処罰登録簿）を検索
• search_cepim - CNPJ、CPF、または上位機関で CEPIM（制裁対象公務員登録簿）を検索
• search_ceis - CNPJ、CPF、機関、または日付範囲で CEIS（資格停止事業体登録簿）を検索
• search_ceaf - CPF、機関、または日付範囲で CEAF（公務員資格停止登録簿）を検索
• search_acordos_leniencia - 氏名、CNPJ、ステータス、または日付範囲で Leniency Agreements を検索
• search_all_registers - 指定した CNPJ または CPF について、すべての登録簿を検索

分析ツール

• check_sanction_status - 終了日をもとに、すべての登録簿で事業体が現在も制裁対象か確認
• get_sanctioning_authorities - 事業体に制裁を科した機関（制裁機関）の情報を取得
• get_location_info - 制裁対象事業体の所在地／州の情報（UF、機関の所在地）を取得
• get_comprehensive_overview - 氏名、機関、日付、所在地、ステータスなど、すべての登録簿から最大限の情報を取得して包括的な概要を提供

ユーティリティツール

• get_sanction_details - 特定の制裁登録簿の種類に関する詳細情報を取得
• check_entity_sanctions - すべての登録簿を対象に、事業体の制裁状況を包括的に確認
• batch_search - 複数の書類（CNPJ または CPF）を1回の操作で検索
• generate_sanctions_report - 複数の検索結果から書式付きテキストレポートを生成

アーキテクチャ

User Query (Natural Language)
    ↓
Tool Selection & Execution
    ↓
MCP Tools / Direct API Calls
    ↓
Brazilian Sanctions API
    ↓
Detailed Sanction Information
    ↓
Natural Language Response

書類番号の形式

システムは書類番号（ブラジルの CNPJ または CPF）を自動的に整形します。整形済み、未整形のどちらの書類番号も使用できます：

# These are equivalent:
"12.345.678/0001-00"
"123456780001000"
"123.456.789-66"
"12345678966"

エラー処理

システムには、包括的なエラー処理が備わっています。

• API 接続エラー
• 無効なドキュメント形式
• API キーの欠落
• レート制限
• 不正な形式のレスポンス

トラブルシューティング

問題	解決策
API キーが見つからない	.env ファイルで PORTAL_TRANSPARENCIA_API_KEY を設定してください
接続がタイムアウトする	インターネット接続と API のステータスを確認してください
レコードが見つからない	CNPJ/CPF の形式を確認し、対象の事業体が存在するか確認してください

参考資料

• API ドキュメント: https://api.portaldatransparencia.gov.br/swagger-ui/index.html
• Porta da Transparência: https://www.portaldatransparencia.gov.br/
• MCP プロトコル: https://modelcontextprotocol.io/
• Ollama: https://ollama.ai/

最終更新日: 2026年6月 API ベース URL: https://api.portaldatransparencia.gov.br/api-de-dados