/ ディレクトリ / プレイグラウンド / mcp-brasil
● コミュニティ jxnxts ⚡ 即起動

mcp-brasil

作者 jxnxts · jxnxts/mcp-brasil

ブラジルの公共API 41件(立法・司法・財政・医療・環境)を自然言語で照会できます。363のツールを搭載し、ほとんどがAPIキー不要です。

mcp-brasilは、ブラジル政府データにまたがる363のMCPツールをバンドルしています。下院(Câmara)・上院(Senado)の法案、STF・STJの判例、Portal da Transparênciaの支出データ、IBGEの統計、BCBの金利、DataSUSの医療データ、INPEの環境フィードに対応しています。planejar_consultaexecutar_loteなどのメタツールにより、複数APIにまたがる調査の計画と並列実行が可能です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

brasil.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "brasil",
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "brasil": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-brasil"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add brasil -- uvx mcp-brasil

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: mcp-brasil

ブラジルの法案を下院・上院にまたがって追跡する方法

👤 ジャーナリスト、政策アナリスト、政府渉外チーム ⏱ ~15 min beginner

使うタイミング: 特定の法案(PL/PEC)の投票、修正、委員会段階をウェブサイトのスクレイピングなしで追跡したい場合に使用します。

前提条件
  • 法案の識別番号(例: PL 2630/2020) — Câmara/SenadoのURLまたはニュース記事から取得
フロー
  1. 法案とその現在のステータスを検索する
    mcp-brasilを使ってCâmaraでPL 2630/2020を検索してください。現在のステータス、提出者、審議経過のタイムラインを表示してください。✓ コピーしました
    → 法案のメタデータと段階履歴を含む構造化レスポンス
  2. 投票と委員会の動きを取得する
    その法案に関するすべての投票と委員会の動きを、日付と結果付きで一覧表示してください。✓ コピーしました
    → 時系列順のイベント一覧
  3. ブリーフィング用に要約する
    3段落のブリーフィングを作成してください:法案の現在の状況、推進者、最も可能性の高い次のステップ。✓ コピーしました
    → 公開可能な政策サマリー

結果: Câmara/Senadoの一次データに基づく、情報源付きの立法ブリーフィングを10分以内で作成できます。

注意点
  • 法案IDが院ごとに異なる — CâmaraのPLとSenadoのPLSは別物 — 必ず院を指定してください。不明な場合はplanejar_consultaで両方を照会します
組み合わせ: notion

mcp-brasilでブラジル政府の契約を監査する

👤 調査報道記者、透明性を推進するNGO ⏱ ~40 min advanced

使うタイミング: 連邦機関の不正支出が疑われ、Portal da Transparência、制裁レジストリ、契約データを照合したい場合に使用します。

前提条件
  • 無料のPortal da Transparência APIキー — api.portaldatransparencia.gov.br で取得(1分程度)、TRANSPARENCIA_API_KEYに設定
フロー
  1. 対象機関の最近の契約を一覧表示する
    過去12か月間にMinistério Xが締結した契約のうち、金額上位20件をサプライヤーのCNPJ付きで取得してください。✓ コピーしました
    → 金額とCNPJ付きの契約一覧テーブル
  2. サプライヤーを制裁レジストリ(CEIS/CEPIM)と照合する
    各CNPJについて、CEISまたはCEPIMの制裁リストに該当するか確認し、一致するものにフラグを立ててください。✓ コピーしました
    → サプライヤーごとのコンプライアンスステータス
  3. 公務員データとクロスリファレンスする
    executar_loteを使って、フラグ付きの全CNPJに対するパートナー検索を並列実行してください。✓ コピーしました
    → 利益相反の可能性があるリード

結果: 法務チームやジャーナリストチームに検証用として渡せる、データに裏付けられたリードリストを作成できます。

注意点
  • 監査中にTransparênciaのレート制限に到達する — バッチサイズを10に制限してスロットリングしてください。executar_loteがバックオフを処理します
  • 姓の一致を証拠として扱ってしまう — 必ず手動で検証してください — これはリード生成であり、結論ではありません
組み合わせ: google-sheets

mcp-brasilでブラジルのマクロダッシュボードを構築する

👤 エコノミスト、フィンテックPM、アナリスト ⏱ ~10 min beginner

使うタイミング: BCB/IBGEのAPIを手動で接続せずに、日次のSELIC、IPCA、為替レートが必要な場合に使用します。

フロー
  1. 本日の主要レートを取得する
    mcp-brasilを使って、本日のSELIC、CDI、IPCA(12か月)、USD/BRLを取得してください。✓ コピーしました
    → 指標ごとのソースとタイムスタンプ付きの現在値
  2. モーニングノートを作成する
    本日の値を30日前と比較し、1シグマを超える変動にフラグを立てたモーニングノートを作成してください。✓ コピーしました
    → Slackに貼り付け可能なフォーマット済みノート

結果: 日次でスケジュール実行可能な、自動更新されるマクロスナップショットを作成できます。

組み合わせ: google-sheets

組み合わせ

他のMCPと組み合わせて10倍の力を

brasil + google-sheets

契約監査やマクロスナップショットを共有シートに直接出力する

mcp-brasilで本日のマクロスナップショットを実行し、'Brasil Macro' Google Sheetに行を追加してください。✓ コピーしました
brasil + notion

各法案をNotionページとして管理する政策トラッキングワークスペース

Comissão X内のすべてのアクティブなPLについて、最新の審議経過でNotionページを作成/更新してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
planejar_consulta question: str 複数APIにまたがる調査の開始時に使用 — サーバーが適切なエンドポイントを選択します 1 local call
executar_lote calls: Call[] CNPJ/CPF/法案IDのリストを一括でエンリッチしたい場合に使用 N upstream calls parallelized
listar_features プロンプトを作成する前に、対応ドメインを確認する場合に使用 0
recomendar_tools query: str やりたいことは分かっているが、363ツールのうちどれが適切か分からない場合に使用 0

コストと制限

運用コスト

APIクォータ
上流APIにより異なる:Câmara/Senadoは実質無制限、Transparênciaはキーあたり約90リクエスト/分、IBGE/BCBは十分な割り当て
呼び出しあたりのトークン
エンドポイントに応じて100〜1500
金額
無料 — 基盤となるAPIはすべて公開されています
ヒント
不要なツール呼び出しを避けるため、最初にplanejar_consultaを使用してください。10ツール必要に見えても2つで済むことがあります

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: オプションのキーを環境変数TRANSPARENCIA_API_KEYDATAJUD_API_KEYMETA_ACCESS_TOKENに設定
データ送信先: リクエストはブラジル政府ドメイン(gov.br、ibge.gov.br、bcb.gov.br)およびMeta Ad Libraryに送信されます

トラブルシューティング

よくあるエラーと対処法

429 Too Many Requests (Portal da Transparência)

executar_loteのバッチサイズを5に縮小し、間隔を空けてください。Transparênciaは上流APIの中で最も制限が厳しいです

確認: 60秒後に同じ呼び出しを再実行してください
Tool not found / unknown feature

listar_featuresを実行してから、自然言語クエリでrecomendar_toolsを実行してください。363ツールの中から適切なものを見つけるにはディスカバリーが必要です

有効なCNPJで空の結果が返される

すべてのCNPJがすべてのレジストリに存在するわけではありません。まずReceita Federalのベースデータを確認してください

代替案

mcp-brasil 他との比較

代替案代わりに使う場面トレードオフ
BrasilAPICEP/CNPJ/銀行情報のみが必要で、単一のHTTPコールで済ませたい場合mcp-brasilの363ツールと比べ、対応範囲が非常に限定的
Direct gov.br API callsAIエージェントワークフローではなく、本番バックエンドを構築する場合すべての接続処理を自分で実装する必要がある

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る