AI导哈

巴西数据查询服务

Brasil API MCP是一个通过标准化模型上下文协议连接AI助手与巴西公共数据服务的桥梁，提供邮政编码、公司注册、银行信息、区号、地理统计数据、货币汇率和域名注册状态等多种信息的查询功能。

  • by guilhermelirio
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 guilhermelirio/brasil-api-mcp

使用说明

巴西API MCP

一种模型上下文协议（MCP）服务器，提供通过以下方式查询各种巴西数据服务的工具 巴西API.

概述

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

  • 邮政编码（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

鸣谢

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

许可证

MIT© 吉列尔梅·利里奥·托马西·德·奥利维拉

相关 MCP