Skip to main content
Glama

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.

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 .

Available Tools

1 tool
hello_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

    C2.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness1/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A 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.
      7
      76
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for sending and receiving WhatsApp messages through Evolution API, enabling management of instances, messages, and chats directly from Claude Code.
      -