Brasil API

🚀 Brasil API MCP

Brasil API MCP 是一個基於 Model Context Protocol (MCP) 的服務器，它藉助 Brasil API 提供工具，可查詢多種巴西公共數據服務，為用戶獲取巴西相關信息提供了便捷途徑。

🚀 快速開始

Brasil API MCP 是連接 AI 助手與巴西公共數據服務的橋樑，通過標準化的 Model Context Protocol 實現。它提供了對多種巴西公共數據的訪問，如郵政編碼、公司註冊號、銀行信息等。

✨ 主要特性

• 提供對多種巴西公共數據的訪問，包括郵政編碼（CEP）、公司註冊號（CNPJ）、銀行信息、區域代碼（DDD）、IBGE 數據、外匯匯率、域名註冊狀態（.br 域名）。
• 通過標準化的 Model Context Protocol 實現與 AI 助手的連接。

📦 安裝指南

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

# 安裝依賴
npm install

# 構建項目
npm run build

💻 使用示例

基礎用法

運行服務器：

npm start

這將啟動通過標準輸入輸出（stdio）通信的 MCP 服務器。

高級用法

根據郵政編碼查詢巴西地址

// 示例請求 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"
});

// 響應提供詳細的匯率信息

📚 詳細文檔

可用工具

CEP (郵政編碼)

• cep-search - 查詢巴西郵政編碼的地址信息

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 域名的狀態和可用性

📄 許可證

MIT © Guilherme Lirio Tomasi de Oliveira

致謝

該項目使用了 Brasil API 服務，該服務聚合了多種與巴西公共數據相關的 API。特別感謝 Brasil API 團隊為社區提供的這項寶貴服務。