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).

Wendell Barreto
https://github.com/wendellbigato

git clone https://github.com/wendellbigato/mcp-cep.git
cd mcp-cep

Altere a URL acima para a real quando publicar.

python3.11 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# ou
.venv\Scripts\activate.bat  # Windows

Usando uv:

uv pip install -e ".[cli]"

Ou com pip normal:

pip install -e ".[cli]"

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.

Após configurar, inicie:

goose 

E envie comandos como:

Repita: Olá!
Qual o endereço do CEP 01001000?

• echo(texto: str): repete o texto enviado.
• buscar_cep(cep: str): consulta informações de endereço via ViaCEP.

Este projeto está licenciado sob a licença MIT.