/ 目錄 / 演練場 / MCP Brasil
● 社群 Mcp-Brasil ⚡ 即開即用

MCP Brasil

作者 Mcp-Brasil · Mcp-Brasil/mcp-brasil

70 個巴西政府與公共事業 API 集於一個 MCP——Claude 所需的每一筆 CEP 查詢、CNPJ 核驗、IBGE 統計與央行匯率,全在其中。

MCP Brasil 將巴西最常用的公共 API 整合為一個 MCP 伺服器:用於郵遞區號的 ViaCEP、聯邦稅局的公司 CNPJ 資料、IBGE 的人口普查與地理統計、BCB 的每日匯率、ANATEL 的電信資料、INPI 的商標與專利,以及數十個其他來源。無需 API 金鑰,無需為每個入口網站申請帳號。專為厭倦了撰寫 70 個不同 fetcher 的巴西開發者與資料分析師而生。

為什麼要用

核心特性

即時演示

實際使用效果

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 位數字,有無格式均可
步驟
  1. 取得 CNPJ 資料
    Use mcp-brasil. Look up CNPJ 33.000.167/0001-01 and tell me legal name, status (ATIVA?), CNAE, capital social, partners.✓ 已複製
    → 含所有欄位的結構化資料
  2. 交叉核驗地址
    Take the registered CEP. Resolve via ViaCEP. Does the city match what Receita reports?✓ 已複製
    → 標示是否相符
  3. 制裁名單核查
    Check the partners' CPFs against any sanction lists this MCP exposes. Anything?✓ 已複製
    → 命中清單或「無異常」

結果: 2 分鐘內從官方來源生成的一頁式交易對手盡職調查備忘錄。

注意事項
  • 聯邦稅局對大量查詢進行速率限制 — 工具已內建重試退避;批次超過 20 筆時,請手動分散間隔
搭配使用: filesystem

在寄件前批次驗證巴西地址(CEP)

👤 物流、電商、CRM 資料清理 ⏱ ~15 min beginner

何時使用: 你有一份包含 CEP 欄位的客戶地址 CSV,在列印 5000 份標籤前想確保資料正確。

前置條件
  • 含 CEP 欄位的 addresses.csv — 任何 CSV 格式;Claude 會自動偵測欄位
步驟
  1. 驗證
    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 含新欄位與標記欄
  2. 核對
    For mismatches between CRM city and ViaCEP city, suggest the corrected city.✓ 已複製
    → 差異報告

結果: 每一列都有來源引用的乾淨地址清單。

注意事項
  • 部分 CEP 是「通用型」(涵蓋整個城市) — ViaCEP 回傳這類 CEP 時不含街區名稱——這是預期行為,不是錯誤
搭配使用: filesystem

取得 IBGE 指標以進行巴西市場資料分析

👤 從事巴西市場的資料分析師 ⏱ ~20 min intermediate

何時使用: 你需要各市或各州的人口、人均 GDP 或 HDI 資料。

步驟
  1. 列出指標
    List IBGE indicators available via mcp-brasil related to GDP per capita.✓ 已複製
    → 指標目錄
  2. 取得各州序列
    Fetch GDP per capita for all 27 estados, latest year. Output to /data/gdp.csv.✓ 已複製
    → 27 列的 CSV
  3. 換算貨幣
    Convert to USD using BCB's official rate as of the same year. Add column.✓ 已複製
    → USD 欄位已附加

結果: 來源自 IBGE 與 BCB 的可重現州級資料集。

注意事項
  • IBGE 指標 ID 偶爾會變更 — 始終從目錄工具開始;不要硬編碼 ID
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

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 無限制、聯邦稅局約每分鐘 3 次、BCB 無限制
每次呼叫 Token 數
100–500
費用
免費
提示
針對大量聯邦稅局查詢,將回應快取至本地 JSON,當天重複使用

安全

權限、密鑰、影響範圍

憑證儲存: 開放資料 API 無需憑證
資料出站: 每次呼叫均發送至其所屬的官方 API(viacep.com.br、receita、bcb、ibge 等)

故障排查

常見錯誤與修復

聯邦稅局 CNPJ 查詢返回 429

已達速率限制。工具會重試一次;否則請等待 60 秒。

驗證: 等待後的單一查詢成功
ViaCEP 返回 erro: true

CEP 不存在或格式錯誤——確認格式為 ddddd-ddd

IBGE 指標某年度無資料

部分指標為多年度週期;查詢目錄以取得可用的 periodos

替代方案

MCP Brasil 對比其他方案

替代方案何時用它替代權衡
BrasilAPI(直接 REST)你想在沒有 MCP 層的情況下呼叫單一端點BrasilAPI 單獨只是一個 CEP/CNPJ 來源;mcp-brasil 聚合了 70 個以上
聯邦稅局直接查詢你需要最具權威性的 CNPJ 資料且能處理其驗證碼流程使用者體驗極差;mcp-brasil 使用快取的開放資料鏡像

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills