MCP-CEP
Servidor MCP para consulta de CEPs usando a API pública do ViaCEP.
Compatível com Goose como extensão de linha de comando (Command-line Extension).
👤 Autor
Wendell Barreto
https://github.com/wendellbigato
🚀 Instalação
1. Clone este repositório
Altere a URL acima para a real quando publicar.
2. Crie e ative o ambiente virtual
3. Instale as dependências com uv
ou pip
Usando uv:
Ou com pip normal:
🧩 Configurando como extensão no Goose
- Execute:
- Selecione
Add Extension
- Escolha
Command-line Extension
- Preencha os campos:
Campo | Valor |
---|---|
Extension name | mcp-cep |
Command to run | /caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py |
Timeout | 300 |
Environment | (em branco, ou personalize se necessário) |
Use which uv
e pwd
para encontrar os caminhos corretos.
✅ Como testar no Goose
Após configurar, inicie:
E envie comandos como:
🧰 Ferramentas disponíveis
echo(texto: str)
: repete o texto enviado.buscar_cep(cep: str)
: consulta informações de endereço via ViaCEP.
📄 Licença
Este projeto está licenciado sob a licença MIT.
This server cannot be installed
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.
A server for querying Brazilian postal codes (CEPs) using the ViaCEP public API, compatible with Goose as a command-line extension.
Related MCP Servers
- AsecurityAlicenseAqualityA server that enables interaction with Square's API via Goose, supporting queries for locations, customers, and more with context preservation and MCP-compliant responses.Last updated -123PythonMIT License
- -securityAlicense-qualityA Goose MCP extension providing voice interaction with modern audio visualization, allowing users to communicate with Goose through speech rather than text.Last updated -59PythonMIT License
- AsecurityFlicenseAqualityQuery a variety of data from Brasil resources seamlessly. Access information on postal codes, area codes, banks, holidays, taxes, and more through a unified interface. Enhance your AI agents and applications with rich and updated data from BrasilAPI effortlessly.Last updated -64TypeScript
- AsecurityAlicenseAqualityAn 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.Last updated -11TypeScriptMIT License