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:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Configurando como extensão no Goose

1. Execute:

goose configure

2. Selecione Add Extension

3. Escolha Command-line Extension

4. Preencha os campos:

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.