Brasil API MCP

一个模型上下文协议 (MCP) 服务器，它提供工具通过 Brasil API 查询各种巴西数据服务。

概述

Brasil API MCP 是一个桥梁，通过标准化的模型上下文协议将 AI 助手连接到巴西公共数据服务。它提供对各种信息的访问，例如：

• 邮政编码 (CEP)
• 公司注册 (CNPJ)
• 银行信息
• 区号 (DDD)
• IBGE（巴西地理与统计研究所）数据
• 货币汇率
• 域名注册状态（.br 域名）

安装

# 克隆仓库
git clone https://github.com/guilhermelirio/brasil-api-mcp
cd brasil-api-mcp

# 安装依赖
npm install

# 构建项目
npm run build

使用

要运行服务器：

npm start

这将启动通过标准输入/输出 (stdio) 通信的 MCP 服务器。

可用工具

CEP（邮政编码）

• cep-search - 从巴西邮政编码 (CEP) 查询地址信息

CNPJ（公司注册）

• cnpj-search - 通过 CNPJ（国家法人登记处）查询有关巴西公司的信息

银行

• bank-search - 通过代码查找有关巴西银行的信息
• bank-list - 列出所有巴西银行

DDD（区号）

• ddd-search - 查找有关巴西区号 (DDD) 的信息

IBGE（地理与统计）

• ibge-states-list - 列出所有巴西州及其信息
• ibge-state-search - 通过代码或缩写查找有关巴西州的信息
• ibge-municipalities-list - 按缩写列出巴西州的所有城市

Cambio（货币兑换）

• cambio-currencies-list - 列出所有可用于汇率的货币
• cambio-rate - 获取特定日期特定货币的汇率

Registro BR（域名注册）

• registrobr-domain-check - 检查 .br 域名的状态和可用性

集成示例

通过邮政编码查询巴西地址

// CEP 工具的示例请求
const response = await callMcpTool("cep-search", {
  cep: "01001000"
});

// 响应提供地址详细信息：
// {
//   cep: "01001000",
//   state: "SP",
//   city: "São Paulo",
//   neighborhood: "Sé",
//   street: "Praça da Sé",
//   service: "viacep"
// }

获取货币汇率

// 获取美元汇率的示例请求
const response = await callMcpTool("cambio-rate", {
  currency: "USD",
  date: "2023-08-10"
});

// 响应提供详细的汇率信息

鸣谢

本项目使用 Brasil API 服务，该服务聚合了与巴西公共数据相关的各种 API。 特别感谢 Brasil API 团队为社区提供这项宝贵的服务。

许可证

MIT © Guilherme Lirio Tomasi de Oliveira