Skip to main content
Glama

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: Speech MCP

🧩 Configurando como extensão no Goose

  1. Execute:

goose configure
  1. Selecione Add Extension

  2. Escolha Command-line Extension

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wendellbigato/mcp-cep'

If you have feedback or need assistance with the MCP directory API, please join our Discord server