MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

S
Smart Shopper MCP Server

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
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" ] } } }