/ 目录 / 演练场 / 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 数据的 Receita Federal、用于人口普查和地理统计的 IBGE、用于每日汇率的 BCB(巴西中央银行)、用于电信数据的 ANATEL、用于商标和专利的 INPI,以及数十个其他接口。无需 API key,无需在各个平台分别注册账号。专为巴西开发者以及任何分析巴西数据、不想重复编写 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 分钟内从官方来源生成一份关于交易对手的一页式尽调备忘录。

注意事项
  • Receita 对高频查询进行限速 — 工具已内置退避重试;批量查询超过 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 免费
cnpj_lookup cnpj: str 验证巴西公司信息 免费(受 Receita 限速)
bcb_rate currency: str, date?: str 需要官方 BRL 汇率时(如用于会计核算) 免费
ibge_indicator indicator_id: str, geo_level: 'br'|'uf'|'municipio', year?: int 获取官方统计数据 免费
inpi_search query: str, kind: 'patent'|'trademark' 商标或专利在先权利查询 免费

成本与限制

运行它的成本

API 配额
按数据源分:ViaCEP 无限制,Receita 约每分钟 3 次,BCB 无限制
每次调用 Token 数
100–500
费用
免费
提示
对于大量 Receita 请求,将当天响应缓存到本地 JSON

安全

权限、密钥、影响范围

凭据存储: 开放数据 API 无需存储凭据
数据出站: 每次调用发往对应的官方 API(viacep.com.br、receita、bcb、ibge 等)

故障排查

常见错误与修复

Receita CNPJ 查询返回 429

触发限速。工具会重试一次;否则请等待 60 秒。

验证: 等待后单次查询成功
ViaCEP 返回 erro: true

CEP 不存在或格式错误——请检查格式 ddddd-ddd

IBGE 指标某年度无数据

部分指标采用多年度发布节奏;通过目录查询可用的 periodos

替代方案

MCP Brasil 对比其他方案

替代方案何时用它替代权衡
BrasilAPI(直接 REST)你只想调用单个接口,不需要 MCP 层BrasilAPI 单独只是一个 CEP/CNPJ 数据源;mcp-brasil 聚合了 70 余个
Receita Federal 直连你需要最权威的 CNPJ 数据,且能处理其验证码流程操作繁琐;mcp-brasil 使用缓存的开放数据镜像

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

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