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
git clone https://github.com/wendellbigato/mcp-cep.git
cd mcp-cep
Altere 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 # Windows
3. Instale as dependências com uv ou pip
Usando uv:
uv pip install -e ".[cli]"
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:
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.
