MCP-CEP

MCP-Server zum Abfragen von Postleitzahlen mithilfe der öffentlichen ViaCEP- API.
Kompatibel mit Goose als Befehlszeilenerweiterung.

👤 Autor

Wendell Barreto
https://github.com/wendellbigato

🚀 Installation

1. Klonen Sie dieses Repository

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

Bitte ändern Sie beim Posten die obige URL in die echte.

2. Erstellen und aktivieren Sie die virtuelle Umgebung

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

3. Installieren Sie Abhängigkeiten mit uv oder pip

Verwenden von UV :

uv pip install -e ".[cli]"

Oder mit normalem Pip:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Einrichten als Erweiterung in Goose

1. Ausführen:

goose configure

2. Wählen Sie Add Extension

3. Wählen Sie Command-line Extension

4. Füllen Sie die Felder aus:

Verwenden Sie which uv und pwd , um die richtigen Pfade zu finden.

✅ So testen Sie auf Goose

Nach der Einrichtung starten Sie:

goose session --with-extension mcp-cep

Und senden Sie Befehle wie:

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

🧰 Verfügbare Tools

• echo(texto: str) : wiederholt den gesendeten Text.

• buscar_cep(cep: str) : Adressinformationen über ViaCEP abfragen.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.