MCP-CEP

MIT License
  • Linux
  • Apple

Integrations

  • Used to clone the repository during installation process.

  • Enables cloning a repository from GitHub to set up the MCP server.

  • Supported as an operating system for running the MCP server with specific activation commands.

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.

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

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. 1. Clone this repository
      2. 2. Create and activate the virtual environment
      3. 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

            • -
              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
            • -
              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
            • -
              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
            • -
              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 -
              2
              TypeScript

            View all related MCP servers

            ID: kkykvazkn5