Servidor MCP de BrasilAPI

Consulte fácilmente diversos datos de recursos de Brasil. Acceda a información sobre códigos postales, prefijos, bancos, días festivos, impuestos y más a través de una interfaz unificada. Optimice sus agentes y aplicaciones de IA con datos completos y actualizados de BrasilAPI .

Consulte la documentación completa y oficial de BrasilAPI aquí .

Herramientas

Este servidor proporciona herramientas para consultar todos los endpoints disponibles desde BrasilAPI. Internamente, utiliza este cliente JS para comunicarse con la API: https://github.com/WillianAgostini/brasilapi-js

Consulta la página de Herramientas en Herrería para inspeccionar y probar cada una de ellas.

Related MCP server: mcp-server-airbnb

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

Para generar una compilación actualizada e inspeccionarla:

npm run build-and-inspect

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Integración con aplicaciones de IA

Corriendo por Smithery

Ejecute el servidor automáticamente a través de Smithery :

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

Uso con Claude

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

Cursor y otras integraciones

Consulta la página del servidor en Smithery para obtener otras opciones de integración como Cursor y más.

Ejecutar el servidor con una copia local

Después de haber descargado este proyecto, puedes ejecutar el servidor usando node :

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

En la raíz del proyecto también hay un Dockerfile para construir y ejecutar la imagen si lo desea.

Inspección de las capacidades del servidor

Puede inspeccionar las capacidades de este servidor MCP usando Smithery:

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

Esto le mostrará todas las herramientas disponibles, sus parámetros y cómo usarlas.

Estructura del proyecto

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