Skip to main content
Glama

MCP-CEP

MCP server for querying ZIP codes using the ViaCEP public API.
Compatible with Goose as a Command-line Extension.


👤 Author

Wendell Barreto
https://github.com/wendellbigato


🚀 Installation

1. Clone this repository

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

Please change the above URL to the real one when posting.


2. Create and activate the virtual environment

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

3. Install dependencies with uv or pip

Using uv :

uv pip install -e ".[cli]"

Or with normal pip:

pip install -e ".[cli]"

Related MCP server: Speech MCP

🧩 Setting up as an extension in Goose

  1. Execute:

goose configure
  1. Select Add Extension

  2. Choose Command-line Extension

  3. Fill in the fields:

Field

Value

Extension name

mcp-cep

Command to run

/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py

Timeout

300

Environment

(blank, or customize if needed)

Use which uv and pwd to find the correct paths.


✅ How to test on Goose

After setting up, start:

goose session --with-extension mcp-cep

And send commands like:

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

🧰 Available tools

  • echo(texto: str) : repeats the sent text.

  • buscar_cep(cep: str) : query address information via ViaCEP.


📄 License

This project is licensed under the MIT License.

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