Evolution API MCP

MCP-сервер для отправки и получения сообщений в WhatsApp напрямую из Claude Code с использованием Evolution API (open-source, self-hosted).

Что он делает

• Создание и управление инстансами WhatsApp

• Отправка текстовых сообщений, медиа, аудио, геопозиции, контактов, опросов, стикеров, кнопок и списков

• Чтение переписок и входящих сообщений

• Реакция на сообщения, архивация чатов, отметка о прочтении

Related MCP server: mcp-evolution

Предварительные требования

• Docker Desktop

• Python 3.11+

• uv (менеджер пакетов Python)

• Claude Code

Установка

1. Запуск Evolution API

git clone https://github.com/SEU_USUARIO/evolution-api-mcp.git
cd evolution-api-mcp
docker compose up -d

Подождите около 15 секунд и протестируйте:

curl http://localhost:8080/

Должен вернуться ответ {"status":200,"message":"Welcome to the Evolution API, it is working!"}.

2. Установка MCP-сервера

uv venv
uv pip install -e .

3. Регистрация в Claude Code

claude mcp add evolution-api -s user -- evolution-api-mcp

Или добавьте вручную в файл ~/.claude.json:

{
  "mcpServers": {
    "evolution-api": {
      "type": "stdio",
      "command": "evolution-api-mcp",
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "evo_mcp_2024"
      }
    }
  }
}

Windows: для команды может потребоваться полный путь к .exe: C:/Users/ВАШ_ПОЛЬЗОВАТЕЛЬ/evolution-api-mcp/.venv/Scripts/evolution-api-mcp.exe

4. Подключение вашего WhatsApp

1. Откройте http://localhost:8080/manager/ в браузере

2. Используйте Global API Key: evo_mcp_2024

3. Создайте инстанс (например: "meuwhats")

4. Нажмите "Gerar QR Code" (Сгенерировать QR-код)

5. Отсканируйте его через WhatsApp: Настройки > Связанные устройства > Привязка устройства

5. Использование!

Перезапустите Claude Code и начните использовать:

> envia uma mensagem pro 5511999999999 dizendo oi
> mostra minhas conversas recentes
> envia uma foto pra fulano

Конфигурация

Стандартный API-ключ в Docker Compose — evo_mcp_2024. Измените его в docker-compose.yml, если хотите.

Структура

evolution-api-mcp/
├── docker-compose.yml          # Evolution API + PostgreSQL
├── pyproject.toml               # Dependencias Python
└── src/evolution_api_mcp/
    ├── server.py                # MCP server (FastMCP + CodeMode)
    ├── client.py                # HTTP client async
    └── tools/
        ├── instance.py          # Criar/conectar/deletar instancias
        ├── messages.py          # Enviar texto, midia, audio, etc.
        └── chat.py              # Listar chats, ler mensagens

Доступные инструменты

Instance (Инстанс)

• create_instance - Создать инстанс WhatsApp

• connect_instance - Подключить и сгенерировать QR-код

• fetch_instances - Список инстансов

• connection_state - Проверить состояние подключения

• logout_instance - Отключить WhatsApp

• restart_instance - Перезапустить инстанс

• delete_instance - Удалить инстанс

Messages (Сообщения)

• send_text - Отправить текст

• send_media - Отправить изображение, видео или документ

• send_audio - Отправить аудио/голосовое сообщение

• send_location - Отправить геопозицию

• send_contact - Отправить контактную карточку

• send_reaction - Отреагировать эмодзи

• send_poll - Отправить опрос

• send_buttons - Отправить интерактивные кнопки

• send_list - Отправить интерактивный список

• send_sticker - Отправить стикер

Chat (Чат)

• find_chats - Список чатов

• find_messages - Чтение сообщений из чата

• archive_chat - Архивация/разархивация чата

• mark_message_as_read - Отметить как прочитанное

Лицензия

MIT