API de evolución de MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para Claude que se integra con la API de Evolution para la automatización de WhatsApp.

Descripción general

Este servidor MCP permite a Claude interactuar con WhatsApp a través de la API Evolution, habilitando capacidades como:

Administrar instancias de WhatsApp
Envío de varios tipos de mensajes
Trabajar con contactos y grupos
Configuración de webhooks y ajustes

📂 Estructura del proyecto

mcp-evo-api/
├── src/
│   ├── tools/          # MCP tools implementation for Evolution API
│   ├── utils/          # Shared utilities, including Evolution API client
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── scripts/            # Helper scripts
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
├── docker-compose.yml  # Docker Compose configuration
├── Dockerfile          # Docker build configuration
└── package.json        # Project dependencies

🚀 Configuración rápida

Configuración del entorno

Cree un archivo .env con sus credenciales de API de Evolution:

EVOLUTION_API_URL=https://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here

📋 Opciones de implementación

Ambiente	Pasos	Dominio
Desarrollo local	1. Clonar e instalar. 2. Ejecutar en modo de desarrollo.	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install` `bun run dev`
Producción local	1. Clonar e instalar 2. Compilar y ejecutar	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install` `bun run build && bun run dist/main.js`
Docker Compose	Ejecutar con Docker Compose	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api` `docker-compose up -d`
Estibador	Construir y ejecutar el contenedor	`docker run -d -p 3000:3000 -e EVOLUTION_API_URL=yoururl -e EVOLUTION_API_KEY=yourkey --name mcp-evo-api ghcr.io/aiteks-ltda/mcp-evo-api:latest`

Configuración del escritorio de Claude

Agregue esto a su archivo de configuración de Claude Desktop (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "evo-api": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-evo-api/dist/main.js"
      ]
    }
  }
}

Si utiliza la implementación de Docker:

{
  "mcpServers": {
    "evo-api": {
      "url": "http://localhost:3000"
    }
  }
}

📊 Estado de implementación

Categoría	Implementado	Pendiente de implementación
API principal	✅ Obtener información✅ Crear instancia✅ Obtener instancias✅ Conectar instancia✅ Reiniciar instancia✅ Estado de conexión✅ Cerrar sesión en instancia✅ Eliminar instancia✅ Establecer presencia	❌ Revisa WhatsApp
Webhook y configuraciones	✅ Establecer webhook✅ Buscar webhook✅ Establecer ajustes✅ Buscar ajustes
Mensajería	✅ Enviar texto sin formato✅ Enviar estado✅ Enviar multimedia✅ Enviar audio de WhatsApp✅ Enviar sticker✅ Enviar ubicación✅ Enviar contacto✅ Enviar reacción✅ Enviar encuesta✅ Enviar lista✅ Enviar botones	❌ Marcar mensaje como leído❌ Marcar mensaje como no leído❌ Archivar chat❌ Eliminar mensaje para todos❌ Actualizar mensaje❌ Enviar presencia (Ctrl de chat)
Chat y contactos	✅ Buscar contactos ✅ Buscar chats	❌ Actualizar estado de bloqueo❌ Obtener URL de imagen de perfil❌ Obtener Base64❌ Buscar mensajes❌ Buscar mensaje de estado
Grupos	✅ Buscar grupo por JID✅ Obtener todos los grupos✅ Buscar miembros del grupo	❌ Crear grupo❌ Actualizar imagen del grupo❌ Actualizar asunto del grupo❌ Actualizar descripción del grupo❌ Obtener código de invitación❌ Revocar código de invitación❌ Enviar invitación al grupo❌ Buscar grupo por código de invitación❌ Actualizar miembros del grupo❌ Actualizar configuración del grupo❌ Activar/desactivar efímero❌ Salir del grupo
Configuración del perfil		❌ Obtener perfil de empresa❌ Obtener perfil❌ Actualizar nombre de perfil❌ Actualizar estado de perfil❌ Actualizar foto de perfil❌ Eliminar foto de perfil❌ Obtener configuración de privacidad❌ Actualizar configuración de privacidad
Integraciones de bots		❌ Integraciones de Typebot ❌ Integraciones de OpenAI ❌ Bot Evolution ❌ Bot Dify ❌ Bot Flowise
Otras integraciones		❌ Chatwoot ❌ Websocket ❌ SQS ❌ RabbitMQ

Para obtener más información, consulte la documentación de la API de Evolution .

MCP Evolution API

Integrations