# MCP-CEP

Servidor MCP para consulta de CEPs usando a API pública do [ViaCEP](https://viacep.com.br).  
Compatível com [Goose](https://block.github.io/goose/) como extensão de linha de comando (Command-line Extension).

---

### 👤 Autor

**Wendell Barreto**  
[https://github.com/wendellbigato](https://github.com/wendellbigato)  


---

## 🚀 Instalação

### 1. Clone este repositório

```bash
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

```bash
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](https://github.com/astral-sh/uv):

```bash
uv pip install -e ".[cli]"
```

Ou com pip normal:

```bash
pip install -e ".[cli]"
```

---

## 🧩 Configurando como extensão no Goose

1. Execute:

```bash
goose configure
```

2. Selecione `Add Extension`

3. Escolha `Command-line Extension`

4. Preencha os campos:

| Campo              | Valor                                                                     |
| ------------------ | ------------------------------------------------------------------------- |
| **Extension name** | `mcp-cep`                                                                 |
| **Command to run** | `/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py` |
| **Timeout**        | `300`                                                                     |
| **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:

```bash
goose 
```

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.