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.
Supported as an operating system for running the MCP server with specific activation commands.
Used as the runtime environment for the MCP server implementation.
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
Please change the above URL to the real one when posting.
2. Create and activate the virtual environment
3. Install dependencies with uv
or pip
Using uv :
Or with normal pip:
🧩 Setting up as an extension in Goose
- Execute:
- Select
Add Extension
- Choose
Command-line Extension
- 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:
And send commands like:
🧰 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
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.
Related MCP Servers
- AsecurityAlicenseAqualityA server that enables interaction with Square's API via Goose, supporting queries for locations, customers, and more with context preservation and MCP-compliant responses.Last updated -123PythonMIT License
- -securityAlicense-qualityA Goose MCP extension providing voice interaction with modern audio visualization, allowing users to communicate with Goose through speech rather than text.Last updated -57PythonMIT License
- -securityFlicense-qualityQuery 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 -4TypeScript
- AsecurityAlicenseAqualityAn 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 -11TypeScriptMIT License