Brazilian CEP MCP

MIT License

# 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.

-
security - not tested
-
license - not tested
-
quality - not tested

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.

  1. Descrição
    1. Funcionalidades
      1. Instalação
        1. Como usar
          1. Compilação do projeto
          2. Execução do servidor
          3. Consultando um CEP
        2. Tecnologias utilizadas
          1. Configuração Smithery
            1. Estrutura do projeto
              1. Autor
                1. Licença
                  1. Contribuições

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      This 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 -
                      1
                      Python
                      Apache 2.0
                      • Linux
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      An 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
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      An 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 -
                      2
                      TypeScript

                    View all related MCP servers

                    ID: tavmhhtx1i