Brazilian CEP MCP

# 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

# Clone o repositório
git clone https://github.com/guilhermelirio/brazilian-cep-mcp.git
cd brazilian-cep-mcp

# Instale as dependências
npm install

Como usar

Compilação do projeto

Para compilar o código TypeScript:

npm run build

Execução do servidor

Para iniciar o servidor em modo de desenvolvimento:

npm run dev

Para iniciar o servidor após compilação:

npm start

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:

{
  "cep": "01001000"
}

Resposta:

Endereço encontrado:
CEP: 01001-000
Logradouro: Praça da Sé
Complemento: lado ímpar
Bairro: Sé
Cidade: São Paulo
Estado: SP (São Paulo)
Região: Sudeste
DDD: 11
IBGE: 3550308

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

brazilian-cep-mcp/
├── src/
│   └── index.ts       # Código-fonte principal
├── dist/              # Código compilado
├── node_modules/      # Dependências
├── smithery.yaml      # Configuração do Smithery
├── package.json       # Configuração do projeto
├── tsconfig.json      # Configuração do TypeScript
└── README.md          # Este arquivo

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

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

mapbox-mcp-server
AidenYangX
A
security
A
license
A
quality
MCP Server for the Mapbox API.
Last updated -
5
3
TypeScript
MIT License
Brasil API MCP
guilhermelirio
-
security
A
license
-
quality
A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.
Last updated -
1
3
TypeScript
MIT License
Countries MCP Server
Pedrohmlara
-
security
F
license
-
quality
An MCP server that provides country-related data from the REST Countries API, allowing users to query information about countries through natural language.
Last updated -
TypeScript
MCP-CEP
wendellbigato
-
security
A
license
-
quality
A server for querying Brazilian postal codes (CEPs) using the ViaCEP public API, compatible with Goose as a command-line extension.
Last updated -
4
Python
MIT License

View all related MCP servers