Skip to main content
Glama

Brazilian CEP MCP

README.md4.93 kB
��# 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.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/guilhermelirio/brazilian-cep-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server