/ 目录 / 演练场 / 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 URL 或新闻文章
步骤
  1. 查找提案及其当前状态
    使用 mcp-brasil 在 Câmara 中查找 PL 2630/2020。显示当前状态、作者和议程进展时间表。✓ 已复制
    → 包含议案元数据和阶段历史的结构化响应
  2. 提取投票和委员会行动
    列出该议案上的每次投票和委员会行动,包括日期和结果。✓ 已复制
    → 事件的时间顺序列表
  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. 列出目标实体的最近合同
    获取部门 X 在过去 12 个月内签署的 20 个最大合同,含供应商 CNPJ。✓ 已复制
    → 含值和 CNPJ 的合同表
  2. 针对制裁登记簿 (CEIS/CEPIM) 检查供应商
    对于每个 CNPJ,检查其是否出现在 CEIS 或 CEPIM 制裁中。标记匹配项。✓ 已复制
    → 逐个供应商的合规状态
  3. 与公务员数据交叉参考
    使用 executar_lote 在所有标记的 CNPJ 上并行化合作伙伴查询。✓ 已复制
    → 潜在的利益冲突线索

结果: 一份数据支持的线索列表,可交给法律或新闻团队进行验证。

注意事项
  • 审计中途触及 Transparência 速率限制 — 使用批大小 10 限制;executar_lote 处理退避
  • 将姓氏匹配视为证明 — 始终手动验证——这是线索生成,不是结论
搭配使用: google-sheets

使用 mcp-brasil 构建实时巴西宏观仪表板

👤 经济学家、fintech PM、分析师 ⏱ ~10 min beginner

何时使用: 需要每日 SELIC、IPCA、汇率,而无需手动连接 BCB/IBGE API。

步骤
  1. 拉取今天的关键利率
    使用 mcp-brasil 给我今天的 SELIC、CDI、IPCA(12m)、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 req/min(每密钥);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 是最严格的上游

验证: 60 秒后重新运行相同调用
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 agent 工作流您需要自己编写所有管道代码

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills