Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Brazilian CEP

FreeNot checked

Integrates with Brazilian postal code (CEP) APIs to retrieve address details for location validation and geolocation services in Node.js applications.

GitHubEmbed

About

Integrates with Brazilian postal code (CEP) APIs to retrieve address details for location validation and geolocation services in Node.js applications.

README

��# 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 bash # 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: bash npm run build ### Execu��o do servidor Para iniciar o servidor em modo de desenvolvimento: bash npm run dev Para iniciar o servidor ap�s compila��o: bash 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: json { "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](LICENSE) para mais detalhes. ## Contribui��es Contribui��es s�o bem-vindas! Sinta-se � vontade para abrir issues ou enviar pull requests.

from github.com/guilhermelirio/brazilian-cep-mcp

Installing Brazilian CEP

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/guilhermelirio/brazilian-cep-mcp

FAQ

Is Brazilian CEP MCP free?

Yes, Brazilian CEP MCP is free — one-click install via Unyly at no cost.

Does Brazilian CEP need an API key?

No, Brazilian CEP runs without API keys or environment variables.

Is Brazilian CEP hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Brazilian CEP in Claude Desktop, Claude Code or Cursor?

Open Brazilian CEP on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Brazilian CEP with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs