S
Smart Shopper MCP Server
by @Bappoz
Um agente de IA assistente de compras desenvolvido com Python e Model Context Protocol (MCP) para gestão inteligente de wishlist e orçamento real.
Created 12/20/2025
Updated 2 days ago
README
Repository documentation and setup instructions
Smart Shop Agent
📖 Sobre o Projeto
Este é um projeto de estudos para entender e explorar os conceitos fundamentais do Model Context Protocol (MCP). O objetivo é criar um agente de IA simples que auxilia no gerenciamento de compras pessoais e controle financeiro.
🎯 Objetivo
Aprender na prática como funciona a criação de servidores MCP, registro de ferramentas (tools) e integração com sistemas de IA, usando um caso de uso real e prático.
🛠️ Funcionalidades
O agente oferece ferramentas para:
- Contexto Financeiro: Visualizar saldo disponível e status da wishlist
- Avaliação de Risco: Analisar o impacto de uma compra no orçamento
- Gerenciar Wishlist: Adicionar itens de interesse com preços e prioridades
- Confirmar Compras: Registrar transações e atualizar o saldo automaticamente
🚀 Como Usar
# Instalar dependências
pip install mcp
# Executar o servidor
cd mcp-server
python server.py
# Testar com MCP Inspector
npx @modelcontextprotocol/inspector python server.py
📚 Tecnologias
- Python - Linguagem principal
- FastMCP - Framework para criar servidores MCP
- JSON - Armazenamento de dados
📝 Status
Projeto em desenvolvimento para fins educacionais.
Quick Setup
Installation guide for this server
Install Package (if required)
uvx smart-shopper-mcp-server
Cursor configuration (mcp.json)
{
"mcpServers": {
"bappoz-smart-shopper-mcp-server": {
"command": "uvx",
"args": [
"smart-shopper-mcp-server"
]
}
}
}