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 .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor de protocolo de contexto de modelo que permite a Claude interactuar con WhatsApp a través de la API Evolution, lo que permite el envío de mensajes, la gestión de contactos, las operaciones de grupo y la administración de instancias de WhatsApp.

Related MCP Servers

API Tester MCP Server
Vikrant-Khedkar
-
security
F
license
-
quality
A Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.
Last updated -
Python
WhatsApp MCP Server
msaelices
A
security
A
license
A
quality
A Python server that enables language models like Claude to interact with WhatsApp Business API through GreenAPI, supporting features like sending messages and managing groups.
Last updated -
5
4
Python
MIT License
WhatsApp Web MCP
fyimail
-
security
A
license
-
quality
A bridge that connects WhatsApp Web to AI models using the Model Context Protocol, enabling Claude and other AI systems to interact with WhatsApp through a standardized interface.
Last updated -
19
4
TypeScript
MIT License
WhatsApp Web MCP
pnizer
-
security
A
license
-
quality
A Node.js application that connects WhatsApp Web with AI models through the Model Context Protocol, enabling automated messaging, contact management, and group chat functionality through AI-driven workflows.
Last updated -
19
18
TypeScript
MIT License

View all related MCP servers

MCP Evolution API