# brazilian-cep-mcp
Descrição
Este é um servidor MCP (Model Context Protocol) que fornece ferramentas para consulta de informações de Códigos de Endereçamento Postal (CEP) brasileiros. O servidor utiliza a API ViaCEP para obter dados detalhados de endereços a partir do CEP informado.
Funcionalidades
- Consulta de endereços completos através do CEP
- Retorno de informações como logradouro, bairro, cidade, estado, região, DDD e código IBGE
- Implementação do protocolo MCP para integração com agentes de IA
Instalação
Como usar
Compilação do projeto
Para compilar o código TypeScript:
Execução do servidor
Para iniciar o servidor em modo de desenvolvimento:
Para iniciar o servidor após compilação:
Consultando um CEP
O servidor disponibiliza a ferramenta consultar-cep
que aceita um parâmetro:
cep
: Código postal no formato de 8 dígitos numéricos (obrigatório)
Exemplo de uso:
Resposta:
Tecnologias utilizadas
- TypeScript
- Node.js
- Axios para requisições HTTP
- Zod para validação de esquemas
- SDK do Model Context Protocol
Configuração Smithery
Este projeto está configurado para funcionar com a plataforma Smithery.ai, que facilita a distribuição e execução de servidores MCP.
Estrutura do projeto
Autor
Guilherme Lirio Tomasi de Oliveira
Licença
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para mais detalhes.
Contribuições
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.
This server cannot be installed
An MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.
Related MCP Servers
- -securityAlicense-qualityMCP Server for the Google Maps API.Last updated -75,30342,199JavaScriptMIT License
- -securityAlicense-qualityThis MCP server provides access to TripAdvisor data for planning vacations, enabling users to search for and get details about locations, attractions, restaurants, and hotels through an interactive planning experience.Last updated -1PythonApache 2.0
- -securityFlicense-qualityAn MCP server that provides access to Paylocity API endpoints, allowing retrieval of employee data, earnings, company codes, local taxes, and pay statements.Last updated -Python
- -securityFlicense-qualityAn MCP server that enables interaction with Datagouv APIs, primarily allowing users to search for up-to-date information about companies registered in France.Last updated -2TypeScript