Calculadora de Propostas T2C Group MCP Server

MCP Apps - Calculadora de Propostas T2C Group

MCP App completo para cálculo de propostas comerciais por custo/hora com histórico persistente, estatísticas avançadas e gráficos interativos.

🚀 Características

• ✅ Cálculo automático de valores baseado em custo/hora, impostos, load, margem e comissão
• 💾 Histórico persistente em JSON de todas as cotações (CRUD completo)
• 📊 Estatísticas avançadas com 3 gráficos interativos (Chart.js)
• 🎨 Interface moderna com suporte a dark/light mode
• 🔧 Dois tipos de cálculo: Projetos (R$ 62,25/h) e Sustentação (R$ 49,11/h)
• 📱 Responsivo e mobile-friendly
• 🔨 Integração Claude Desktop via MCP Protocol

📊 Preview

Interface Principal

Estatísticas e Gráficos

🏗️ Arquitetura

┌─────────────────────────────────────────┐
│           CLAUDE DESKTOP                │
│  "Crie uma cotação para projeto X..."  │
└────────────────┬────────────────────────┘
                 │ MCP Protocol (stdio)
                 ▼
┌─────────────────────────────────────────┐
│        NODE.JS MCP SERVER               │
│  • 4 Tools (CRUD)                       │
│  • Validação Zod                        │
│  • Persistência JSON                    │
└────────────────┬────────────────────────┘
                 │
                 ├──► data/quotations.json
                 │
                 └──► UI Resource (HTML/JS/CSS)
                      └─► Chart.js Graphs

🔧 4 Tools MCP

📦 Instalação

Pré-requisitos

• Node.js 18+
• npm 9+
• Claude Desktop
• Git

1. Clone o repositório

git clone https://github.com/silvaleo1979/MCP_APPS.git
cd MCP_APPS/calculadora-proposta-mcp

2. Instale as dependências

npm install

3. Build do projeto

npm run build

4. Configure no Claude Desktop

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Adicione:

{
  "mcpServers": {
    "calculadora-proposta": {
      "command": "node",
      "args": [
        "/caminho/completo/para/MCP_APPS/calculadora-proposta-mcp/dist/index.js",
        "--stdio"
      ]
    }
  }
}

5. Reinicie o Claude Desktop

1. Feche todas as janelas
2. Quit do system tray
3. Reabra o Claude Desktop
4. Verifique o ícone 🔨

💻 Desenvolvimento

Scripts disponíveis

# Desenvolvimento com hot reload
npm run dev

# Build para produção
npm run build

# Testar com HTTP (navegador)
npm run start:http
# Acesse: http://localhost:3001/mcp

# Testar com stdio (Claude Desktop)
npm run start:stdio

📊 Estatísticas e Gráficos

O módulo de estatísticas oferece:

📈 Cards de Métricas

• Total de Cotações
• Valor Total Cotado
• Valor Médio
• Total de Horas

📊 Gráficos Interativos

1. Distribuição por Tipo (Donut) - Projetos vs Sustentação
2. Top 5 Maiores Cotações (Barras horizontais)
3. Evolução Temporal (Linha) - Últimas 10 cotações

💰 Fórmula de Cálculo

Custo Base (R$ 62,25 Projetos | R$ 49,11 Sustentação)
  ↓
+ Imposto 22%
  ↓
+ Load 35%
  ↓
= Custo/Hora Total Empresa
  ↓
+ Margem (configurável)
  ↓
+ Comissão (configurável)
  ↓
= Valor/Hora Final ao Cliente
  ↓
× Horas Previstas
  ↓
= VALOR TOTAL DO PROJETO

🎯 Exemplos de Uso

Criar Cotação

Crie uma cotação para o cliente "Tech Solutions" tipo Projetos com:
- Backend API: 200 horas, margem 60%
- Frontend React: 150 horas, margem 55%
- Observação: "Projeto estratégico"

Listar Histórico

Liste as últimas 10 cotações salvas

Ver Detalhes

Mostre os detalhes da cotação #1738782123456

Estatísticas

Mostre as estatísticas e gráficos das cotações

📁 Estrutura do Projeto

calculadora-proposta-mcp/
├── package.json              # Dependências e scripts
├── tsconfig.json             # Config TypeScript (UI)
├── tsconfig.server.json      # Config TypeScript (Server)
├── vite.config.ts            # Config Vite bundler
├── server.ts                 # 4 tools MCP
├── main.ts                   # Entry point
├── mcp-app.html             # Template HTML
├── src/
│   ├── mcp-app.ts