Brazilian PEP (Politically Exposed Person)

ブラジルの PEP MCP サーバー

Porta da Transparência API を通じて、ブラジルの PEP（重要な公的地位にある人物）および連邦公務員のデータにアクセスできる MCP（Model Context Protocol）サーバーです。

コンポーネント

• mcp_server.py - ブラジルの PEP と公務員を検索するツールを公開する MCP サーバー
• pyproject.toml - プロジェクトの依存関係と設定
• requirements.txt - Python の依存関係

機能

• CPF、氏名、役職、機関、期間で PEP（重要な公的地位にある人物）を検索
• 連邦行政機関の職員（文民および軍人）を検索
• 公務員の報酬データを照会
• 機関ごとに集計された公務員を検索
• 信頼職の職務および役職を照会
• 個人の包括的な PEP ステータスを取得
• API レスポンスから特定のフィールドを抽出
• 安全な API キー認証
• 非同期対応のツール実行

データソース

ソース	用途	検索条件
PEP	重要な公的地位にある人物	CPF、氏名、役職、機関、期間
公務員	連邦行政機関の職員	CPF、氏名、機関、種類、状況
報酬	公務員の報酬	CPF、ID、月／年
機関別	機関ごとの公務員	機関コード、種類、リンクの種類
職務と役職	職務と役職	ページネーション

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

クエリの例：

• 「CPF 123.456.789-00 が PEP かどうか確認して」
• 「経済省で Silva という名前の公務員を検索して」
• 「CPF 987.654.321-00 の公務員について、2026 年 1 月の報酬データを取得して」
• 「機関 25000 の PEP をすべて一覧表示して」
• 「信頼職の職務と役職を検索して」

MCP サーバーのツール

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

PEP 検索ツール

• search_peps - CPF、氏名、役職、機関、期間で PEP を検索
• get_pep_info - CPF で人物の包括的な PEP 情報を取得

公務員検索ツール

• search_servidores - CPF、氏名、機関、種類、状況で連邦行政機関の職員を検索
• get_servidor_by_id - ID で特定の公務員を取得
• search_servidores_remuneracao - CPF または ID と月／年で公務員の報酬を検索
• search_servidores_por_orgao - 機関ごとに集計された公務員を検索
• search_funcoes_e_cargos - 信頼職の職務と役職を検索

アーキテクチャ

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

文書番号の形式

システムは文書番号（ブラジルの CPF）を自動的に正規化します。区切り記号の有無にかかわらず使用できます：

# These are equivalent:
"123.456.789-00"
"12345678900"

エラー処理

システムには、包括的なエラー処理が含まれています：

• API 接続エラー
• 無効な文書形式
• API キーの不足
• レート制限
• 不正な形式のレスポンス

トラブルシューティング

問題	解決方法
API キーが見つからない	.env ファイルに PORTAL_TRANSPARENCIA_API_KEY を設定します
接続がタイムアウトする	インターネット接続と API のステータスを確認します
レコードが見つからない	CPF の形式を確認し、人物が存在するか確認します
401 Unauthorized	API キーが正しく、有効であることを確認します

参考資料

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

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