MCP-CEP

MIT License
1
  • 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

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

🧩 Configurando como extensão no Goose

  1. Execute:
goose configure
  1. Selecione Add Extension
  2. Escolha Command-line Extension
  3. Preencha os campos:
CampoValor
Extension namemcp-cep
Command to run/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py
Timeout300
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 session --with-extension mcp-cep

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.

-
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. 👤 Autor
    1. 🚀 Instalação
      1. 1. Clone este repositório
      2. 2. Crie e ative o ambiente virtual
      3. 3. Instale as dependências com uv ou pip
    2. 🧩 Configurando como extensão no Goose
      1. ✅ Como testar no Goose
        1. 🧰 Ferramentas disponíveis
          1. 📄 Licença

            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