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.

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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