Serve

Um assistente de chat que entende linguagem natural e gerencia o cadastro de Clientes e Produtos de um pequeno sistema, usando Gemini (LLM) + MCP (Model Context Protocol) + SQLite.

Em vez de preencher formulários, você conversa:

"Cria um cliente Maria Silva, CPF 123.456.789-00, email [email protected]" "Quais produtos eu tenho com menos de 10 unidades em estoque?" "Atualiza o preço do Notebook pra 3200"

...e o sistema entende o pedido, executa a ação no banco de dados e confirma o que foi feito.

Como funciona

Vue.js (chat)  →  Backend Bridge (FastAPI)  →  Gemini (decide o que fazer)
                          ↓                              ↓
                   MCP Client  ←──────────────  "chame a tool X"
                          ↓
                   MCP Server (server.py)
                          ↓
                        SQLite

1. Você escreve um pedido no chat (frontend em Vue.js).
2. O Backend Bridge (FastAPI) manda essa mensagem pro Gemini, junto com a lista de ações disponíveis (as tools do MCP Server).
3. O Gemini interpreta o pedido e decide quais ações executar — por exemplo, "chamar a tool criar_cliente com esses dados".
4. O Bridge executa essa ação no MCP Server, que é quem efetivamente lê e escreve no banco SQLite.
5. O resultado volta pro Gemini, que formula uma resposta em português, e essa resposta aparece no chat.

Funcionalidades

O MCP Server expõe 10 ações (tools) que o Gemini pode usar:

Clientes (identificados pelo CPF)

• Criar cliente
• Listar todos os clientes
• Buscar cliente por CPF
• Atualizar dados de um cliente
• Remover um cliente

Produtos (identificados pelo nome)

• Criar produto
• Listar todos os produtos
• Buscar produto por nome
• Atualizar preço/estoque de um produto
• Remover um produto

Estrutura do projeto

mcp-serve/
├── server.py           # MCP Server: define as tools de CRUD
├── database.py          # Schema e conexão com o SQLite
├── requirements.txt      # Dependências do MCP Server
├── bridge/               # Backend que conecta Vue <-> Gemini <-> MCP Server
│   ├── main.py
│   ├── requirements.txt
│   └── .env.example
├── frontend/              # Interface de chat em Vue.js
│   └── src/
├── docs/
│   └── documentacao.md   # Guia técnico: como rodar e testar
└── README.md              # Este arquivo

Stack

• MCP Server: Python + SDK oficial mcp (FastMCP)
• Banco de dados: SQLite
• LLM: Google Gemini (via google-genai), com function calling automático
• Bridge: FastAPI
• Frontend: Vue 3 + Vite

Quer rodar na sua máquina?

Veja o passo a passo completo (instalação, configuração da API key do Gemini e como testar) em docs/documentacao.md.