Mcp Cep
What is Mcp Cep
mcp-cep is an MCP server designed for querying Brazilian postal codes (CEPs) using the public ViaCEP API. It is compatible with Goose as a command-line extension.
Use cases
Use cases include customer address validation in e-commerce platforms, geographic data analysis, and enhancing user experience in applications requiring location-based services.
How to use
To use mcp-cep, clone the repository, create and activate a virtual environment, and install dependencies using either ‘uv’ or ‘pip’. Configure it as a command-line extension in Goose and start a session to send commands.
Key features
Key features include integration with the ViaCEP API for postal code queries, compatibility with Goose, and a command-line interface for easy interaction.
Where to use
mcp-cep can be used in applications that require postal code validation, address lookup, or integration with services that rely on Brazilian postal codes.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Cep
mcp-cep is an MCP server designed for querying Brazilian postal codes (CEPs) using the public ViaCEP API. It is compatible with Goose as a command-line extension.
Use cases
Use cases include customer address validation in e-commerce platforms, geographic data analysis, and enhancing user experience in applications requiring location-based services.
How to use
To use mcp-cep, clone the repository, create and activate a virtual environment, and install dependencies using either ‘uv’ or ‘pip’. Configure it as a command-line extension in Goose and start a session to send commands.
Key features
Key features include integration with the ViaCEP API for postal code queries, compatibility with Goose, and a command-line interface for easy interaction.
Where to use
mcp-cep can be used in applications that require postal code validation, address lookup, or integration with services that rely on Brazilian postal codes.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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]"
🧩 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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
