BrasilAPI MCP Server

本地服务

smithery.ai开发工具784 周前更新

代码仓库访问官网

关于 BrasilAPI MCP Server

BrasilAPI MCP Server 将 BrasilAPI 的端点提供给 AI 应用和 Agent，涵盖邮编、银行、节假日、税务等巴西数据，并通过统一工具访问。

主要功能

01查询邮编和区号数据
02获取银行与节假日信息
03访问税务等 BrasilAPI 端点
04通过 Smithery 查看工具和参数

适用场景

01查询巴西邮政编码
02核对区号或银行信息
03获取节假日或税务数据

MCP 相关

它提供 MCP 工具来查询 BrasilAPI 的所有端点，供 MCP 客户端访问巴西数据。

#mcp #llm #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "brasil-api": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

BrasilAPI MCP 服务

轻松查询各种 Brasil 资源数据。通过统一接口获取邮政编码、区号、银行、节假日、税务等信息。借助 BrasilAPI 中丰富且最新的数据，为你的 AI Agent 和应用赋能。

点击此处查看 BrasilAPI 完整的官方文档。

工具

此服务提供工具，用于查询 BrasilAPI 提供的所有端点。它在底层使用这个 JS 客户端与 API 通信：https://github.com/WillianAgostini/brasilapi-js

前往 Smithery 的工具页面查看并测试每个工具。

开发

安装依赖：

npm install

构建服务：

npm run build

开发时自动重新构建：

npm run watch

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

生成最新构建并进行检查：

npm run build-and-inspect

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

与 AI 应用集成

通过 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 运行服务：

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

项目根目录下还有一个 Dockerfile，你可以用它构建并运行镜像。

查看服务能力

你可以使用 Smithery 查看此 MCP 服务的能力：

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

此操作会显示所有可用工具、它们的参数以及使用方法。

项目结构

src/
  ├── apiClient/   # BrasilAPI client
  ├── tools/       # Tools implementations
  ├── types/       # Interfaces and types
  ├── utils/       # Utility functions
  └── index.ts     # MCP main file (server setup and tools listing)

支持 Markdown

登录后评论