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
🚀 Instalação
1. Clone este repositório
git clone https://github.com/wendellbigato/mcp-cep.git
cd mcp-cepAltere a URL acima para a real quando publicar.
2. Crie e ative o ambiente virtual
python3.11 -m venv .venv
source .venv/bin/activate # Linux/macOS
# ou
.venv\Scripts\activate.bat # Windows3. Instale as dependências com uv ou pip
Usando uv:
uv pip install -e ".[cli]"Ou com pip normal:
pip install -e ".[cli]"🧩 Configurando como extensão no Goose
- Execute:
goose configure- 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:
goose E envie comandos como:
Repita: Olá!
Qual o endereço do CEP 01001000?🧰 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.