Brasil API MCP

这是一个通过Brasil API查询各种巴西数据服务的Model Context Protocol (MCP)服务器工具。

概述

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-0-10"
});

// 响应提供详细的兑换信息

致谢

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

许可证

MIT © Guilherme Lirio Tomasi de Oliveira