MCP Evolution API
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
Related MCP server: Evolution API MCP Server
📂 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. |
|
Producción local | 1. Clonar e instalar 2. Compilar y ejecutar |
|
Docker Compose | Ejecutar con Docker Compose |
|
Estibador | Construir y ejecutar el contenedor |
|
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 .
Available Tools
1 toolhello_toolD
Hello tool
Inputs: name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is inherently distinct by default.
A single tool cannot demonstrate inconsistency, as there are no other tool names to compare it to. The naming pattern for 'hello_tool' (snake_case) is consistent within the set, albeit trivially so.
A single tool is generally too few for most server purposes, as it limits functionality and suggests an incomplete or trivial implementation. While it might be appropriate for a minimal 'hello world' server, it is inadequate for any substantive domain coverage.
With only one tool named 'hello_tool', it is impossible to infer a meaningful domain or assess coverage. There are obvious gaps, as no CRUD operations, lifecycle management, or typical API interactions are present, making the surface severely incomplete for any practical purpose.
Maintenance
Related MCP Connectors
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
WhatsApp for Claude, ChatGPT or any AI agent: search, reply and send. Personal or Business API.
Hosted WhatsApp MCP for Claude and ChatGPT: read chats, find who awaits a reply.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server that connects your personal WhatsApp account to AI agents like Claude, enabling them to search messages, view contacts, retrieve chat history, and send messages via WhatsApp.776ISC
- AlicenseNot gradedqualityDmaintenanceEnables WhatsApp integration through Evolution API, allowing users to send messages, manage media, track conversations, and control presence status directly from Claude.MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables interaction with WhatsApp through local stdio or remote HTTP/SSE connections. It allows users to send messages, manage groups, and access chat history using natural language.3-
- FlicenseNot gradedqualityDmaintenanceMCP server for sending and receiving WhatsApp messages through Evolution API, enabling management of instances, messages, and chats directly from Claude Code.-