# MCP Server — Análise de Vendas e Estoque

Servidor MCP de treino: expõe ferramentas para um LLM consultar vendas, identificar
produtos sem estoque, ver os mais vendidos e sugerir o que comprar.

## Instalação

```bash
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
```

## Popular o banco com dados fake

```bash
python seed.py
```

Isso cria `vendas.db` com ~30 produtos e 90 dias de histórico de vendas simulado.
Rode de novo a qualquer momento para recriar os dados do zero.

## Testar com o MCP Inspector

```bash
mcp dev server.py
```

Abre uma interface web onde dá pra chamar cada tool manualmente e ver o resultado.

## Ferramentas disponíveis

- `listar_produtos(categoria=None)` — lista produtos com preço e estoque.
- `produtos_sem_estoque()` — produtos no estoque mínimo ou abaixo.
- `produtos_mais_vendidos(dias=30, limite=10)` — ranking de vendas.
- `resumo_vendas(dias=30)` — receita total, quantidade e ticket médio.
- `sugerir_reposicao(dias=30)` — quanto comprar de cada produto, por urgência.

Também há o resource `schema://vendas-db` (schema do banco) e o prompt
`analisar_vendas` (guia uma análise completa).

## Usar no Claude Code

```bash
claude mcp add vendas -- python "<caminho-absoluto>/server.py"
```

Depois pergunte algo como "quais produtos estão sem estoque?" ou
"o que eu deveria comprar essa semana?".