MCP-CEP

Сервер MCP для запроса почтовых индексов с использованием публичного API ViaCEP .
Совместимо с Goose как расширение командной строки.

👤 Автор

Уэнделл Баррето
https://github.com/wendellbigato

🚀 Установка

1. Клонировать этот репозиторий

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

При публикации, пожалуйста, измените указанный выше URL-адрес на реальный.

2. Создать и активировать виртуальную среду

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

3. Установите зависимости с помощью uv или pip

Использование УФ :

uv pip install -e ".[cli]"

Или с обычным пипом:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Настройка расширения в Goose

1. Выполнять:

goose configure

2. Выберите Add Extension

3. Выберите Command-line Extension

4. Заполните поля:

Используйте which uv и pwd , чтобы найти правильные пути.

✅ Как провести тест на гусе

После настройки запустите:

goose session --with-extension mcp-cep

И отправьте команды типа:

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

🧰 Доступные инструменты

• echo(texto: str) : повторяет отправленный текст.

• buscar_cep(cep: str) : запросить информацию об адресе через ViaCEP.

📄 Лицензия

Данный проект лицензирован по лицензии MIT.