WallisonLucas13/Mcp-Cep-Server
If you are the rightful owner of Mcp-Cep-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The MCP CEP Server is a Model Context Protocol server designed for querying Brazilian postal codes (CEPs) and calculating distances between addresses.
🇧🇷 MCP CEP Server
Servidor Model Context Protocol (MCP) para consulta de CEPs brasileiros e cálculo de distâncias entre endereços.
✨ Funcionalidades
- 📍 Consulta de CEP: Busca detalhada de endereços brasileiros via CEP
- 🗺️ Geocodificação: Conversão precisa de endereços em coordenadas geográficas
- 📏 Matriz de Distâncias: Cálculo de distâncias e tempo de viagem entre localidades
- ⏱️ Estimativas de Tempo: Tempo estimado de deslocamento entre pontos
- 🎯 Dados Oficiais: Utiliza informações dos Correios e APIs de geolocalização
🔧 Tools Disponíveis
cep_address_details
Busca informações completas de um endereço a partir do CEP.
Parâmetros:
cep
(string): CEP brasileiro (com ou sem hífen)
Retorna:
- Logradouro, bairro, cidade, UF, estado, região
- Código IBGE, DDD, SIAFI
geocode_accurate
Obtém coordenadas geográficas precisas de um endereço.
Parâmetros:
address
(string): Endereço completo
Retorna:
- Latitude e longitude precisas
distance_matrix_accurate
Calcula matriz de distâncias entre origens e destinos.
Parâmetros:
origins
(string): Endereços de origemdestinations
(string): Endereços de destino
Retorna:
- Distância em km e metros
- Tempo estimado de viagem
- Status da operação
🚀 Como Usar
Este servidor MCP pode ser integrado com clientes compatíveis como Claude Desktop, VS Code ou outras ferramentas que suportem o protocolo MCP.
🌎 Cobertura
- ✅ Todos os CEPs brasileiros
- ✅ Capitais e interior
- ✅ Endereços urbanos e rurais
- ✅ Dados atualizados dos Correios
📊 Exemplo de Uso
// Consulta de CEP
{
"cep": "01310-100",
"logradouro": "Avenida Paulista",
"bairro": "Bela Vista",
"localidade": "São Paulo",
"uf": "SP"
}
// Matriz de distância
{
"distance": "15.2 km",
"duration": "23 mins"
}