mirror of https://github.com/EvolutionAPI/evolution-api.git synced 2025-12-26 15:17:44 -06:00

Files

Claude dc2f3fe93f 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.

2025-11-14 01:39:58 +00:00

3.1 KiB

Raw Blame History

🚀 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

cd mcp-server
npm install

Passo 2: Configurar Banco de Dados

Crie o arquivo .env:

cp .env.example .env

Edite .env e configure sua string de conexão PostgreSQL:

DATABASE_CONNECTION_URI=postgresql://postgres:senha@localhost:5432/evolution

Passo 3: Compilar

npm run build

Passo 4: Configurar Claude Desktop

macOS/Linux

Abra o arquivo de configuração:

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

Cole esta configuração (ajuste o caminho):

{
  "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

Abra o arquivo de configuração:

notepad %APPDATA%\Claude\claude_desktop_config.json

Cole esta configuração (ajuste o caminho):

{
  "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

Verifique se o caminho no claude_desktop_config.json está correto (use caminho ABSOLUTO)
Verifique se o arquivo foi compilado: ls mcp-server/dist/index.js
Reinicie o Claude Desktop completamente
Veja os logs: Menu > Help > Show Logs

Erro de conexão com banco

Teste a conexão manualmente:

psql "postgresql://postgres:senha@localhost:5432/evolution"

Verifique se o PostgreSQL está rodando
Verifique usuário, senha e nome do banco

Para testar localmente (sem Claude Desktop)

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 completo.

Pronto! Agora você pode analisar suas mensagens do WhatsApp com o poder do Claude! 🚀

3.1 KiB Raw Blame History