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.
This commit is contained in:
Claude
2025-11-14 01:39:58 +00:00
parent df20c5fc93
commit dc2f3fe93f
8 changed files with 1645 additions and 0 deletions

37
mcp-server/package.json Normal file
View File

@@ -0,0 +1,37 @@
{
"name": "evolution-api-mcp-server",
"version": "1.0.0",
"description": "MCP Server para análise de mensagens do Evolution API via PostgreSQL",
"type": "module",
"main": "dist/index.js",
"bin": {
"evolution-mcp": "./dist/index.js"
},
"scripts": {
"build": "tsc",
"dev": "tsx src/index.ts",
"start": "node dist/index.js",
"watch": "tsx watch src/index.ts"
},
"keywords": [
"mcp",
"model-context-protocol",
"evolution-api",
"whatsapp",
"database",
"postgresql"
],
"author": "Evolution API",
"license": "Apache-2.0",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.0.4",
"pg": "^8.13.1",
"dotenv": "^16.4.7"
},
"devDependencies": {
"@types/node": "^24.5.2",
"@types/pg": "^8.11.10",
"tsx": "^4.20.5",
"typescript": "^5.7.2"
}
}