Skip to main content
Glama
Sign In
deenesjakoptruzh

MCP-CEP

by wendellbigato
GitHub
Python
MIT License
2
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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]"

🧩 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:
FieldValue
Extension namemcp-cep
Command to run/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py
Timeout300
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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A server for querying Brazilian postal codes (CEPs) using the ViaCEP public API, compatible with Goose as a command-line extension.

  1. 👤 Author
    1. 🚀 Installation
      1. Clone this repository
      2. Create and activate the virtual environment
      3. Install dependencies with uv or pip
    2. 🧩 Setting up as an extension in Goose
      1. ✅ How to test on Goose
        1. 🧰 Available tools
          1. 📄 License

            Related MCP Servers

            • brasil-api-mcp-server

              mauricio-cantu
              -
              security
              F
              license
              -
              quality
              Query a variety of data from Brasil resources seamlessly. Access information on postal codes, area codes, banks, holidays, taxes, and more through a unified interface. Enhance your AI agents and applications with rich and updated data from BrasilAPI effortlessly.
              Last updated -
              3
              TypeScript

            • MCP SearxNG Search

              Jay4242
              -
              security
              A
              license
              -
              quality
              An MCP server that enables web searches using a SearxNG instance, allowing MCP-compatible applications like Goose to perform internet searches.
              Last updated -
              Python
              GPL 3.0

            • Brazilian CEP MCP

              guilhermelirio
              -
              security
              -
              license
              -
              quality
              An MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.
              Last updated -
              TypeScript
              MIT License

            • Data Gouv MCP Server

              csonigo
              -
              security
              F
              license
              -
              quality
              An MCP server that enables interaction with Datagouv APIs, primarily allowing users to search for up-to-date information about companies registered in France.
              Last updated -
              6
              TypeScript

            View all related MCP servers

            New MCP Servers

            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