brazilian-cep-mcp
1
The brazilian-cep-mcp project is an MCP server for querying Brazilian postal code information using the ViaCEP API. It facilitates integration with AI agents via the MCP protocol and supports deployment on the Smithery.ai platform.
Overview
brazilian-cep-mcp is an MCP server offering tools for querying postal code (CEP) information in Brazil using the ViaCEP API. It features complete address lookups from CEP, returning details like street, neighborhood, city, state, region, DDD, and IBGE code. Implemented with the MCP protocol, it facilitates integration with AI agents.
Features
- Full address lookup via CEP
- Information includes street, neighborhood, city, state, region, DDD, and IBGE code
Installation
- Clone the repository
- Install dependencies with npm
Usage
- Compile the TypeScript code with npm
- Start the server in development or production mode
Technologies Used
- TypeScript, Node.js
- Uses Axios for HTTP requests and Zod for schema validation
Integration
- Configured for Smithery.ai platform to support MCP server deployment
Project Structure
- Main code in
src/ - Configured with
smithery.yaml
Contributions
Contributions are welcome via issues or pull requests.