Skip to main content
Glama
jeanavila997-ux

base-clientes-mcp

# Base Clientes MCP

Base de dados de clientes com MCP (Model Context Protocol) para agentes locais. Painel administrativo completo com dashboard, chat IA, terminal integrado, plugins, skills, PWA e instalador.

Estrutura

base-clientes-mcp/
├── app/                    # Frontend React
│   ├── admin/              # Layout, sidebar, config, logs
│   ├── chat/               # Chat IA com MCP
│   ├── clientes/           # CRUD de clientes
│   ├── dashboard/          # Dashboard
│   ├── mcp/                # Testador de tools MCP
│   ├── plugins/            # Gerenciador de plugins
│   ├── skills/             # Gerenciador de skills
│   ├── terminal/           # Terminal integrado
│   └── core/               # App principal e login
├── server/                 # Backend Node.js
│   ├── api/                # Rotas REST + WebSocket
│   ├── database/           # SQLite (better-sqlite3)
│   ├── mcp/                # Servidor MCP
│   ├── plugins/            # Loader de plugins
│   ├── skills/             # Loader de skills
│   ├── config/             # Logger e settings
│   └── logs/               # Logs do sistema
├── data/                   # Banco de dados e uploads
├── installer/              # Instalador Windows (.ps1)
├── uninstaller/            # Desinstalador
├── public/                 # Assets e PWA
└── docs/                   # Documentacao

Requisitos

  • Node.js 18+

  • Windows 10/11 (para instalador)

Instalacao rapida

cd C:\Users\JEANPC\base-clientes-mcp
npm install
copy .env.example .env
npm run dev

Acesse http://localhost:5173

Login padrao: admin / admin123

Scripts

  • npm run dev — inicia API + cliente simultaneamente

  • npm run server — inicia apenas API (porta 7777)

  • npm run client — inicia apenas Vite (porta 5173)

  • npm run build — build de producao

  • npm run preview — preview do build (porta 3456)

  • npm run install-service — instala como servico Windows

  • npm run uninstall-service — remove o servico

Funcionalidades

  • CRUD completo de clientes com filtros

  • Dashboard com estatisticas

  • Chat IA integrado com ferramentas MCP

  • Terminal integrado (comandos locais)

  • Painel MCP para testar tools

  • Sistema de plugins e skills (ativar/desativar)

  • Logs de sistema

  • Configuracoes via ADM

  • PWA instalavel

  • Instalador/uninstall Windows

Credenciais padrao

  • Usuario: admin

  • Senha: admin123

Licenca

MIT