MCP-CEP

Servidor MCP para consultar códigos postales mediante la API pública de ViaCEP .
Compatible con Goose como una extensión de línea de comandos.

👤 Autor

Wendell Barreto
https://github.com/wendellbigato

🚀 Instalación

1. Clonar este repositorio

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

Cambie la URL anterior a la real al publicar.

2. Crear y activar el entorno virtual

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

3. Instalar dependencias con uv o pip

Usando uv :

uv pip install -e ".[cli]"

O con pip normal:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩Configuración como extensión en Goose

1. Ejecutar:

goose configure

2. Seleccione Add Extension

3. Elija Command-line Extension

4. Rellene los campos:

Utilice which uv y pwd para encontrar las rutas correctas.

✅ Cómo hacer la prueba en Goose

Después de la configuración, comience:

goose session --with-extension mcp-cep

Y enviar comandos como:

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

🧰 Herramientas disponibles

• echo(texto: str) : repite el texto enviado.

• buscar_cep(cep: str) : consulta información de dirección vía ViaCEP.

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT.