Skip to main content
Glama
MCP Automotivo

MCP Automotivo

by raphamaster

🚗 MCP – Sistema de Análise de Dados Automotivos

Python MariaDB Google%20Gemini Docker

Sistema inteligente de anĂĄlise de dados utilizando Google Gemini e MariaDB

Projeto desenvolvido para fins de estudo e portfĂłlio.

📋 Sobre o Projeto

Este é um projeto MCP (Model Context Protocol) que demonstra a integração entre um modelo de IA generativa (Google Gemini) e um banco de dados MariaDB, permitindo realizar anålises de dados usando linguagem natural.

🎯 Objetivos Educacionais

  • Demonstrar na prĂĄtica a comunicação entre LLMs e bancos de dados

  • Implementar um sistema completo de anĂĄlise utilizando NLP

  • Criar um ambiente funcional com Docker + Python + SQL

  • Servir como material de estudo em IA aplicada e engenharia de dados

Related MCP server: MCP-Driven Data Management System

đŸ—ïž Arquitetura do Sistema

projeto-mcp-automotivo/
├── 📁 database/
│   └── dados_fake_completo.sql
├── 📁 src/
│   ├── database.py
│   ├── mcp_gemini.py
│   ├── requirements.txt
│   └── .env
├── docker-compose.yml
└── README.md

🚀 Tecnologias Utilizadas

  • Python 3.10+

  • MariaDB 11.4

  • Google Gemini 2.0 Flash

  • Docker

  • pandas

⚙ Funcionalidades

🔍 Análise com Linguagem Natural

  • Perguntas diretas em portuguĂȘs

  • Geração automĂĄtica de queries SQL

  • Execução e interpretação inteligente dos resultados

đŸ› ïž Instalação RĂĄpida

git clone https://github.com/raphamaster/projeto-mcp-automotivo.git
cd projeto-mcp-automotivo

# Subir banco de dados via Docker
docker-compose up -d

# Instalar dependĂȘncias do Python
pip install -r src/requirements.txt

# Executar o sistema
python src/mcp_gemini.py

💡 Como Usar

Exemplos de perguntas simples:

"Qual o faturamento total?"
"Quais sĂŁo os 5 produtos mais vendidos?"
"Quem sĂŁo os melhores vendedores?"

Perguntas mais elaboradas para testar a LLMs:

"Qual categoria de produtos tem a melhor margem de lucro (diferença entre preço de venda e custo) e quantas unidades foram vendidas de cada categoria no Ășltimo mĂȘs?"

"Quais clientes do tipo 'Oficina' tĂȘm o maior ticket mĂ©dio e qual a frequĂȘncia de compras deles? Mostre tambĂ©m o valor total gasto por cada um."

"Como evoluiu o faturamento mensal nos Ășltimos 6 meses? Mostre a variação percentual mĂȘs a mĂȘs e identifique se hĂĄ alguma tendĂȘncia de crescimento ou queda."

"Compare a performance dos vendedores considerando nĂŁo apenas o faturamento, mas tambĂ©m o nĂșmero de vendas realizadas e o tempo que cada um estĂĄ na empresa. Quem tem a melhor eficiĂȘncia?"

"Quais produtos tĂȘm alta demanda (muitas vendas) mas estoque baixo, representando risco de ruptura? E quais tĂȘm estoque alto mas pouca saĂ­da, representando capital parado?"

"Qual Ă© o produto 'carro-chefe' de cada categoria em termos de faturamento?"

"Existe correlação entre o valor da venda e a forma de pagamento escolhida?"

"Quais vendedores sĂŁo mais eficientes em vender produtos de alta margem?"

📘 Projeto desenvolvido para aprendizado prático

Sinta-se Ă  vontade para explorar, modificar e ampliar o sistema.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language database operations on MySQL databases with AI integration, supporting CRUD operations, schema inspection, and audit logging with built-in security features including SQL injection protection and permission controls.
    751 npm
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language interaction with heterogeneous databases (MySQL and PostgreSQL) for CRUD operations across customer, product, and sales data with intelligent query routing and visualization capabilities.
    -
  • F
    license
    B
    quality
    D
    maintenance
    Enables natural language interaction with MySQL Sakila database through intent-based tools for movie search, customer management, rental operations, and business analytics without exposing database schema.
    18
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables schema inspection, SELECT queries, and confirmation-gated write/DDL/transaction operations on MySQL and MariaDB databases through natural language.
    14
    4 npm
    MIT