BrasilAPI MCP 服务器

通过统一的接口无缝查询各种巴西资源的数据。获取邮政编码、区号、银行、节日、税收等信息。使用丰富且更新及时的 BrasilAPI 数据增强您的 AI 代理和应用程序。

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

工具

此服务器提供了访问 BrasilAPI 每个端点的工具。底层使用以下 JS 客户端与 API 通信：GitHub 链接

查看 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 /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 客户端
  ├── tools/       # 工具实现
  ├── types/       # 接口和类型
  ├── utils/       # 工具函数
  └── index.ts     # MCP 主文件（服务器设置和工具列表）

以上是完整的中文翻译，包含所有原始内容的信息。