mcpField
M
mcp-brasil-api

mcp-brasil-api

本地服务
github.com/codespar法律与政务2754 周前更新
代码仓库

关于 mcp-brasil-api

面向巴西公开数据的 MCP 服务，将 BrasilAPI 的查询接口提供给 AI Agent 使用。无需认证，可查询邮编、企业、银行、节假日、车辆价格、天气和税率等信息。

主要功能

  1. 01提供 24 个查询工具
  2. 02查询 CEP 地址与 CNPJ 企业信息
  3. 03查询银行、节假日和 FIPE 车辆数据
  4. 04获取天气、税率及 IBGE 地区数据
  5. 05无需 API 密钥或环境变量

适用场景

  1. 01按 CEP 查询巴西地址
  2. 02查找企业 CNPJ 信息
  3. 03查询 FIPE 车辆价格
  4. 04获取城市天气或年度节假日

MCP 相关

将 BrasilAPI 的公开数据查询封装为 MCP 工具，供 MCP 客户端调用；无需身份验证。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-brasil-api": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-brasil-api"
      ]
    }
  }
}
启动命令npx -y @codespar/mcp-brasil-api

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-brasil-api0.2.2

工具

24

收录的工具列表 · 更新于 2 周前

参数类型必填说明
cepstring是CEP（8 位数字，例如 01001000）

详细介绍

@codespar/mcp-brasil-api

面向 BrasilAPI 的 MCP 服务——提供 CEP、CNPJ、银行、节假日、FIPE 等免费公共数据 API

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}
Claude Code
claude mcp add brasil-api -- npx @codespar/mcp-brasil-api
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}

工具（24 个）

工具用途
get_cep根据 CEP（巴西邮政编码）查询地址
get_cnpj根据 CNPJ 查询公司信息
get_banks列出所有巴西银行及其代码和名称
get_holidays列出指定年份的全国性节假日
get_fipe_brands按类型列出 FIPE 表中的车辆品牌
get_fipe_price根据代码从 FIPE 表中查询车辆价格
get_ddd获取 DDD（区号）对应的州和城市
get_isbn根据 ISBN 查询图书信息
get_ncm查询 NCM 税收分类代码
get_cptec_weather获取城市天气预报（CPTEC/INPE）
get_pix_participants列出 Pix 参与机构（已接入 Pix 的 PSP/银行）
get_domain_info查询 .br 域名注册信息
get_ibge_municipalities列出巴西某州的所有市镇（IBGE 数据）
get_tax_rates获取当前巴西税率/经济指标（Selic、CDI、IPCA）
get_cptec_cities按名称搜索 CPTEC/INPE 城市，以获取天气预报
get_cep_v1使用 BrasilAPI v1 根据 CEP 查询地址（单一数据源，通常比 v2 更快）
get_fipe_vehicles根据 FIPE 品牌代码和车辆类型列出车辆型号
get_fipe_tables列出 FIPE 参考表（可用于 FIPE 查询的月份/年份）
get_cptec_airport_weather根据 ICAO 代码从 CPTEC/INPE 获取机场当前天气（METAR）
get_cptec_capitals_weather获取巴西所有州首府的当前天气状况
get_cptec_ocean_forecast获取沿海城市的海洋/海浪预报（CPTEC/INPE）
get_ibge_states列出巴西所有州/UF 及其 IBGE 代码和元数据
get_corretoras列出所有在 CVM 注册的巴西经纪公司（corretoras）
get_corretora根据 CNPJ 查询单家在 CVM 注册的经纪公司

身份验证

无需身份验证。BrasilAPI 是免费的公共 API。

沙盒 / 测试

无需沙盒。BrasilAPI 免费开放，所有请求均可使用。

获取凭据

无需凭据。安装后即可使用。

环境变量

无需设置环境变量。

路线图

v0.2（计划中）
  • get_pix_participants — 获取 Pix 参与机构列表
  • get_domain_info — 获取域名注册信息
  • get_vehicle_info — 根据车牌获取车辆信息（FIPE）
  • get_ibge_municipalities — 按州列出市镇（IBGE）
  • get_tax_rates — 获取当前税率（Selic、CDI、IPCA）
v0.3（计划中）
  • get_cvm_funds — 获取 CVM 投资基金数据
  • get_election_results — 按地区获取选举结果

欢迎贡献！提交 PR 或请求新工具。

链接

企业版

需要为 Agent 付款设置治理机制、预算限额和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。