# 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

```bash
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