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

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

Related MCP server: Inventory Analysis MCP Server

Popular o banco com dados fake

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

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

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?".