/ 目錄 / 演練場 / mcp-brasil
● 社群 jxnxts ⚡ 即開即用

mcp-brasil

作者 jxnxts · jxnxts/mcp-brasil

以自然語言查詢 41 個巴西公共 API(立法、司法、財政、衛生、環境)— 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

如何透過 Câmara 和 Senado 追蹤巴西法案進度

👤 記者、政策分析師、政府事務團隊 ⏱ ~15 min beginner

何時使用: 當你需要追蹤特定提案(PL/PEC)的投票、修正案及委員會審查階段,而不想手動爬取網站時。

前置條件
  • 法案識別碼(例如 PL 2630/2020) — 從 Câmara/Senado 網址或新聞報導中取得
步驟
  1. 尋找提案及其目前狀態
    使用 mcp-brasil 在 Câmara 中查詢 PL 2630/2020。顯示目前狀態、提案人及審議時間軸。✓ 已複製
    → 包含法案基本資料與審議階段歷程的結構化回應
  2. 取得投票與委員會行動紀錄
    列出該法案的每一次投票和委員會行動,附上日期與結果。✓ 已複製
    → 依時間排序的事件清單
  3. 整理為簡報摘要
    撰寫 3 段摘要:法案目前進度、推動者是誰,以及最可能的下一步。✓ 已複製
    → 可直接發布的政策摘要

結果: 在 10 分鐘內,以 Câmara/Senado 原始資料為基礎,產出一份附有來源的立法簡報。

注意事項
  • 不同議院的法案 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 申請,約一分鐘完成,設定 TRANSPARENCIA_API_KEY
步驟
  1. 列出目標機構的近期合約
    取得 Ministério X 在過去 12 個月簽訂的前 20 大合約,附供應商 CNPJ。✓ 已複製
    → 包含金額與 CNPJ 的合約表格
  2. 對照制裁名單(CEIS/CEPIM)檢查供應商
    針對每個 CNPJ,確認是否出現在 CEIS 或 CEPIM 制裁名單中,並標記符合項目。✓ 已複製
    → 逐一供應商的合規狀態
  3. 與公務員資料交叉比對
    使用 executar_lote 對所有被標記的 CNPJ 並行執行合夥人查詢。✓ 已複製
    → 潛在利益衝突線索

結果: 產出一份以資料為基礎的線索清單,可交予法律或新聞團隊進一步查證。

注意事項
  • 稽核過程中觸及 Transparência 的請求頻率限制 — 將批次大小限制為 10;executar_lote 會自動處理退避邏輯
  • 將姓名吻合視為確定證據 — 務必人工查證 — 這只是線索產生階段,並非最終結論
搭配使用: google-sheets

使用 mcp-brasil 建立巴西即時總體經濟儀表板

👤 經濟學家、金融科技產品經理、分析師 ⏱ ~10 min beginner

何時使用: 當你需要每日 SELIC、IPCA、câmbio 資料,而不想手動串接 BCB/IBGE API 時。

步驟
  1. 取得今日主要利率
    使用 mcp-brasil 提供今日的 SELIC、CDI、IPCA(12 個月)及 USD/BRL 匯率。✓ 已複製
    → 每項指標附來源與時間戳記的當前數值
  2. 產出早間簡報
    撰寫一份早間簡報,比較今日數值與 30 天前的差異,並標記超過 1 個標準差的波動。✓ 已複製
    → 可直接貼至 Slack 的格式化簡報

結果: 產出一份可每日排程執行的總體經濟快照。

搭配使用: google-sheets

組合

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

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 配額
上游限制各異:Câmara/Senado 實際上無限制;Transparência 每支金鑰約 90 次請求/分鐘;IBGE/BCB 限制寬鬆
每次呼叫 Token 數
100–1500,依端點而異
費用
免費 — 所有底層 API 均為公開資料
提示
先使用 planejar_consulta,避免 2 個工具就能解決的問題卻呼叫了 10 個

安全

權限、密鑰、影響範圍

憑證儲存: 選用金鑰存放於環境變數 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 是限制最嚴格的上游服務

驗證: Re-run the same call after 60s
Tool not found / unknown feature

先執行 listar_features,再以自然語言查詢執行 recomendar_tools — 363 個工具的龐大範圍需要透過探索來定位

Empty result for a valid CNPJ

並非所有 CNPJ 都會出現在每個登錄系統中;請先確認 Receita Federal 基本資料

替代方案

mcp-brasil 對比其他方案

替代方案何時用它替代權衡
BrasilAPI只需要 CEP/CNPJ/銀行資料,且希望單一 HTTP 呼叫即可完成涵蓋範圍遠比 mcp-brasil 的 363 個工具小得多
Direct gov.br API calls你正在建立生產環境後端,而非 AI 代理工作流程所有串接邏輯都需要自行撰寫

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

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