Brasil Api MCP Server

🚀 BrasilAPI MCP 服務器

通過統一的接口，本服務器可無縫查詢各類巴西資源的數據。您能獲取郵政編碼、區號、銀行、節日、稅收等信息，藉助豐富且更新及時的 BrasilAPI 數據，增強您的 AI 代理和應用程序。

🚀 快速開始

查看完整的官方文檔 此處。

✨ 主要特性

• 提供統一接口，無縫查詢各種巴西資源的數據。
• 數據豐富且更新及時，可用於增強 AI 代理和應用程序。

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

帶有自動重建的開發

npm run watch

💻 使用示例

基礎用法

通過 Smithery 運行

使用 Smithery 自動運行此服務器：

npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server

與 Claude 使用

npx -y @smithery/cli@latest install @mauricio-cantu/brasil-api-mcp-server --client claude

高級用法

其他集成（如 Cursor）

查看 Smithery 平臺上的服務器頁面，獲取其他集成選項，例如 Cursor 等。

使用本地副本運行服務器

下載此項目後，可以使用以下命令運行服務器：

node /absolute/path/to/brasil-api-mcp-server/build/index.js

在項目的根目錄下還有一個 Dockerfile 文件，可用於構建和運行鏡像。

📚 詳細文檔

工具

此服務器提供了訪問 BrasilAPI 每個端點的工具。底層使用以下 JS 客戶端與 API 通信：GitHub 鏈接。查看 Smithery 平臺上的工具頁面，以檢查和測試每個工具。

調試

由於 MCP 服務器通過 stdio 通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

要生成更新的構建並檢查：

npm run build-and-inspect

Inspector 會提供一個 URL，用於在瀏覽器中訪問調試工具。

服務器功能檢查

您可以使用 Smithery 檢查此 MCP 服務器的功能：

npx -y @smithery/cli@latest inspect @mauricio-cantu/brasil-api-mcp-server

這將顯示所有可用工具、它們的參數以及如何使用它們。

🔧 技術細節

項目結構

src/
  ├── apiClient/   # BrasilAPI 客戶端
  ├── tools/       # 工具實現
  ├── types/       # 接口和類型
  ├── utils/       # 工具函數
  └── index.ts     # MCP 主文件（服務器設置和工具列表）