Brasil API MCP

一个通过Brasil API查询各种巴西数据服务的模型上下文协议（MCP）服务器。

概览

Brasil API MCP 是一座桥梁，它通过标准化的模型上下文协议将AI助手与巴西公共数据服务连接起来。它提供了访问多种信息的能力，例如：

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

安装

# Clone the repository
git clone https://github.com/guilhermelirio/brasil-api-mcp
cd brasil-api-mcp

# Install dependencies
npm install

# Build the project
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域名的状态和可用性

集成示例

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

// Sample request to the CEP tool
const response = await callMcpTool("cep-search", {
  cep: "01001000"
});

// Response provides address details:
// {
//   cep: "01001000",
//   state: "SP",
//   city: "São Paulo",
//   neighborhood: "Sé",
//   street: "Praça da Sé",
//   service: "viacep"
// }

获取货币汇率

// Sample request to get USD exchange rate
const response = await callMcpTool("cambio-rate", {
  currency: "USD",
  date: "2023-08-10"
});

// Response provides detailed exchange information

致谢

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

许可证

MIT © Guilherme Lirio Tomasi de Oliveira