MCP Brasil — ユースケース, インストール & ライブデモ

Name: MCP Brasil MCP Server
Author: Mcp-Brasil

なぜ使うのか

主な機能

ブラジル公開API 70件以上を統合
オープンデータサブセットはAPIキー不要
ViaCEP / BrasilAPI / OpenCEPのフォールバックチェーンでCEP検索が常に成功
自動レート制限処理付きReceita Federal CNPJ検索
BCB日次為替レートとSELICタイムシリーズ
ブラジルの開発者コミュニティによりメンテナンス

ライブデモ

実際の動作

mcp-brasil.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-brasil",
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-brasil": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-brasil"
        ]
      }
    }
  }
}

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

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

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

ユースケース

実用的な使い方： MCP Brasil

ブラジルの取引相手にCNPJベースのデューデリジェンスを実施する方法

👤 ブラジルのB2B販売者、弁護士、フィンテックオペレーション ⏱ ~10 min intermediate

使うタイミング： ベンダーと契約を結ぶ前に、公式情報源から法的ステータス・パートナー・住所を確認したい場合。

前提条件

取引相手のCNPJ — 14桁の番号、書式あり・なし両方可

フロー

CNPJプロフィールを取得する

Use mcp-brasil. Look up CNPJ 33.000.167/0001-01 and tell me legal name, status (ATIVA?), CNAE, capital social, partners.✓ コピーしました

→ 全フィールドを含む構造化プロフィール
住所をクロスチェックする

Take the registered CEP. Resolve via ViaCEP. Does the city match what Receita reports?✓ コピーしました

→ 一致・不一致がフラグ表示される
制裁リストを確認する

Check the partners' CPFs against any sanction lists this MCP exposes. Anything?✓ コピーしました

→ ヒットのリストまたは「クリーン」

結果： 公式情報源から2分で作成された取引相手の1ページDDメモ。

注意点

Receitaが積極的な検索をレート制限する — ツールはすでにリトライでバックオフします；20件以上のバッチは手動で間隔を空けてください

組み合わせ： filesystem

郵送前にブラジルの住所（CEP）をバッチで検証する

👤 物流・Eコマース・CRMのクリーンアップ ⏱ ~15 min beginner

使うタイミング： 顧客住所とCEPのCSVがあり、5000件のラベルを印刷する前に正確であることを確認したい場合。

前提条件

CEP列を含むaddresses.csv — 任意のCSV；Claudeが列を自動検出します

フロー

検証する

Use mcp-brasil. For every CEP in /data/addresses.csv, fetch via ViaCEP. Append city, state, neighborhood. Flag CEPs that don't resolve.✓ コピーしました

→ 新しい列とフラグ列が追加されたvalidated.csv
照合する

For mismatches between CRM city and ViaCEP city, suggest the corrected city.✓ コピーしました

→ 差分レポート

結果： 行ごとにソースが引用された、クリーンな住所リスト。

注意点

一部のCEPは「genéricos」（市全体） — ViaCEPはそれらを近隣なしで返します — エラーではなく想定通りの動作です

組み合わせ： filesystem

ブラジル重点データ分析のためにIBGE指標を取得する

👤 ブラジル市場で作業するデータアナリスト ⏱ ~20 min intermediate

使うタイミング： 市区町村または州ごとの人口・一人当たりGDP・HDIデータが必要な場合。

フロー

指標を一覧表示する

List IBGE indicators available via mcp-brasil related to GDP per capita.✓ コピーしました

→ 指標カタログ
州レベルのシリーズを取得する

Fetch GDP per capita for all 27 estados, latest year. Output to /data/gdp.csv.✓ コピーしました

→ 27行のCSV
通貨と組み合わせる

Convert to USD using BCB's official rate as of the same year. Add column.✓ コピーしました

→ USD列が追加される

結果： IBGE + BCBをソースとする、再現可能な州レベルデータセット。

注意点

IBGE指標IDが時折変更される — 必ずカタログツールから開始してください；IDをハードコードしないでください

組み合わせ： filesystem

組み合わせ

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

mcp-brasil + filesystem

住所またはCNPJのCSVをバッチ検証する

Read /data/clients.csv, validate every CNPJ via mcp-brasil, write /data/clients_validated.csv.✓ コピーしました

mcp-brasil + postgres

Postgresテーブルに公開データの列を追加する

For every row in companies, fill in ibge_municipio_id using the registered CEP via mcp-brasil.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
viacep	cep: str	ブラジルのCEPを解決する	free
cnpj_lookup	cnpj: str	ブラジル企業を確認する	free (rate-limited by Receita)
bcb_rate	currency: str, date?: str	公式BRL換算レートが必要な場合（会計処理など）	free
ibge_indicator	indicator_id: str, geo_level: 'br'\|'uf'\|'municipio', year?: int	公式統計を取得する	free
inpi_search	query: str, kind: 'patent'\|'trademark'	商標・特許の先行技術調査	free

コストと制限

運用コスト

APIクォータ: ソースごと：ViaCEP無制限、Receita約3リクエスト/分、BCB無制限
呼び出しあたりのトークン: 100〜500
金額: 無料
ヒント: Receita中心のジョブはレスポンスをその日のローカルJSONにバッチキャッシュしてください

セキュリティ

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

認証情報の保管： オープンデータAPIには不要

データ送信先： 各呼び出しはその基盤となる公式API（viacep.com.br、receita、bcb、ibgeなど）に送信されます

実在の人物のCPF/CNPJを渡す場合は、他の識別子と同様にPIIとして扱ってください

トラブルシューティング

よくあるエラーと対処法

Receita CNPJ検索が429を返す

レート制限されています。ツールは一度リトライします；それ以外は60秒待ってください。

確認： 待機後に単一の検索が成功すること

ViaCEPがerro: trueを返す

CEPが存在しないか不正な形式です — 形式ddddd-dddを確認してください

IBGE指標で年のデータが返らない

一部の指標は複数年ごとの更新です；カタログで利用可能なperiodosを確認してください

代替案

MCP Brasil 他との比較

代替案	代わりに使う場面	トレードオフ
BrasilAPI（直接REST）	MCPレイヤーなしで単一エンドポイントを呼び出したい場合	BrasilAPI単体は1つのCEP/CNPJソース；mcp-brasilは70件以上を集約します
Receita Federal直接	最も権威あるCNPJデータが必要で、captchaワークフローを処理できる場合	UXが複雑；mcp-brasilはキャッシュ済みオープンデータミラーを使用します

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

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