brasil-data-mcp 是一个开源 MCP 服务器,将巴西公共数据以工具(tools)形式暴露给 AI 客户端,让用户用自然语言提问即可获取结构化数据。它由 BrasilAPI 驱动,无需密钥、无需认证,数据来自官方来源。
用途:连接 AI 客户端与巴西公共数据,避免手动爬取或编写 HTTP 集成。用户可以直接询问 CNPJ 公司信息、CEP 地址、银行代码、节假日、区号、ISBN、经济指标、汇率、CVM 经纪商、IBGE 州/市、.br 域名可用性等。
主要能力:提供 15 个工具,覆盖 CNPJ、CEP、银行、节假日、DDD、ISBN、经济指标(SELIC/CDI/IPCA)、汇率(PTAX/BACEN)、CVM 经纪商、IBGE 州和市、.br 域名可用性。此外提供 2 个 MCP 提示(prompts):analise-cnpj 和 panorama-economico,用于引导式工作流。可选启用高级数据源(通过环境变量 CPFCNPJ_TOKEN),启用后 consultar_cnpj 可实时查询官方数据(D+0),并新增 consultar_cpf 和 consultar_inscricao_estadual 两个工具;若高级源失败,会自动回退到 BrasilAPI。
使用方式:通过 npx -y brasil-data-mcp 运行,无需全局安装。在 Claude Desktop 中编辑配置文件(macOS:~/Library/Application Support/Claude/claude_desktop_config.json;Windows:%APPDATA%\Claude\claude_desktop_config.json),重启后即可使用。在 Cursor 中创建或编辑项目根目录的 .cursor/mcp.json。在 Claude Code 中可使用命令 claude mcp add brasil-data -e CPFCNPJ_TOKEN=seu-token -- npx -y brasil-data-mcp 添加。高级数据源令牌需在 cpfcnpj.com.br/dev 获取,每次查询消耗账户积分。
适用场景:适合巴西开发者日常使用 LLM 时查询公共数据,例如查询公司注册信息、地址、银行、节假日、经济指标、汇率、域名可用性等。也适合需要将巴西公共数据集成到 AI 工作流中的场景。
限制:默认数据来自 BrasilAPI,可能不是实时数据;高级数据源需要付费令牌,且每次查询消耗积分。项目为开源 MIT 许可,无恶意速率限制。FIPE 数据尚未支持,等待上游稳定。