feat: adiciona MCP Server para análise de mensagens do PostgreSQL

Implementa um servidor MCP (Model Context Protocol) completo que permite ao Claude
analisar mensagens e dados do Evolution API diretamente do PostgreSQL.

Funcionalidades incluídas:
- list_instances: Lista instâncias WhatsApp
- get_messages: Busca mensagens com filtros avançados
- search_messages: Busca por conteúdo de texto
- get_conversation: Obtém conversas completas
- get_message_stats: Estatísticas detalhadas
- get_contacts: Lista contatos
- get_chats: Lista chats ativos
- get_instance_details: Detalhes de instâncias
- execute_query: Queries SQL personalizadas (apenas SELECT)

Inclui documentação completa, guia rápido e exemplos de configuração
para Claude Desktop.

mcp-server/QUICKSTART.md

@@ -0,0 +1,153 @@
+# 🚀 Guia Rápido - Evolution API MCP Server
+
+Este é um guia rápido para configurar o MCP Server em **5 minutos**.
+
+## Passo 1: Instalar Dependências
+
+```bash
+cd mcp-server
+npm install
+```
+
+## Passo 2: Configurar Banco de Dados
+
+Crie o arquivo `.env`:
+
+```bash
+cp .env.example .env
+```
+
+Edite `.env` e configure sua string de conexão PostgreSQL:
+
+```env
+DATABASE_CONNECTION_URI=postgresql://postgres:senha@localhost:5432/evolution
+```
+
+## Passo 3: Compilar
+
+```bash
+npm run build
+```
+
+## Passo 4: Configurar Claude Desktop
+
+### macOS/Linux
+
+1. Abra o arquivo de configuração:
+   ```bash
+   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
+   ```
+
+2. Cole esta configuração (ajuste o caminho):
+   ```json
+   {
+     "mcpServers": {
+       "evolution-api": {
+         "command": "node",
+         "args": [
+           "/home/user/evolution-api/mcp-server/dist/index.js"
+         ],
+         "env": {
+           "DATABASE_CONNECTION_URI": "postgresql://postgres:senha@localhost:5432/evolution"
+         }
+       }
+     }
+   }
+   ```
+
+### Windows
+
+1. Abra o arquivo de configuração:
+   ```
+   notepad %APPDATA%\Claude\claude_desktop_config.json
+   ```
+
+2. Cole esta configuração (ajuste o caminho):
+   ```json
+   {
+     "mcpServers": {
+       "evolution-api": {
+         "command": "node",
+         "args": [
+           "C:\\Users\\SeuUsuario\\evolution-api\\mcp-server\\dist\\index.js"
+         ],
+         "env": {
+           "DATABASE_CONNECTION_URI": "postgresql://postgres:senha@localhost:5432/evolution"
+         }
+       }
+     }
+   }
+   ```
+
+## Passo 5: Reiniciar Claude Desktop
+
+Feche completamente o Claude Desktop e abra novamente.
+
+## ✅ Testar
+
+Abra o Claude Desktop e digite:
+
+```
+Liste todas as instâncias do Evolution API
+```
+
+Se funcionar, você verá a lista de instâncias! 🎉
+
+## 🔍 Exemplos de Comandos
+
+Experimente estes comandos no Claude Desktop:
+
+```
+Mostre as últimas 10 mensagens da instância "minha-instancia"
+```
+
+```
+Busque mensagens contendo "pedido" nas últimas 24 horas
+```
+
+```
+Mostre estatísticas de mensagens da instância "vendas" agrupadas por dia
+```
+
+```
+Liste os contatos da instância "suporte"
+```
+
+```
+Mostre a conversa completa com o número 5511999999999@s.whatsapp.net
+```
+
+## 🐛 Problemas?
+
+### Claude Desktop não mostra o MCP
+
+1. Verifique se o caminho no `claude_desktop_config.json` está correto (use caminho ABSOLUTO)
+2. Verifique se o arquivo foi compilado: `ls mcp-server/dist/index.js`
+3. Reinicie o Claude Desktop completamente
+4. Veja os logs: Menu > Help > Show Logs
+
+### Erro de conexão com banco
+
+1. Teste a conexão manualmente:
+   ```bash
+   psql "postgresql://postgres:senha@localhost:5432/evolution"
+   ```
+2. Verifique se o PostgreSQL está rodando
+3. Verifique usuário, senha e nome do banco
+
+### Para testar localmente (sem Claude Desktop)
+
+```bash
+cd mcp-server
+npm run dev
+```
+
+Isso iniciará o servidor MCP em modo stdio (você verá uma mensagem no console).
+
+## 📚 Documentação Completa
+
+Para mais detalhes, consulte o [README.md](README.md) completo.
+
+---
+
+**Pronto!** Agora você pode analisar suas mensagens do WhatsApp com o poder do Claude! 🚀