de en es ja ko ru zh

mcp-evolution

Name: mcp-evolution
Author: billyfranklim1

by billyfranklim1

Overview Schema Related Servers Score Discussions

TypeScript

Remote

mcp-evolution

npm version license

TypeScript MCP-сервер для Evolution API (WhatsApp) с привязкой к экземпляру.

Архитектура

Этот сервер реализует Model Context Protocol:

Транспорт: stdio — MCP-хост (Claude Desktop, Claude Code и т. д.) запускает этот процесс и общается через JSON-RPC по stdin/stdout.
Сервер: использует высокоуровневый класс McpServer из официального SDK для TypeScript, который автоматически обрабатывает согласование возможностей и жизненный цикл сессии.
Инструменты: 50 инструментов, зарегистрированных через registerTool() со схемами ввода, проверенными Zod — SDK принудительно проверяет типы перед запуском обработчика.

Все три параметра подключения (URL API, ключ API, имя экземпляра) фиксируются при запуске через переменные окружения. ИИ-вызывающий не может переключать экземпляры во время разговора.

Related MCP server: mcp-evolution-api

Инструменты

Сообщения

Инструмент	Описание
`send_text`	Отправка текстового сообщения
`send_media`	Отправка изображения, видео, аудио или документа
`send_audio`	Отправка аудио WhatsApp (голосовое сообщение PTT)
`send_sticker`	Отправка стикера (webp)
`send_location`	Отправка геопозиции
`send_contact`	Отправка одного или нескольких контактов (vCards)
`send_reaction`	Реакция на сообщение с помощью эмодзи
`send_poll`	Отправка опроса
`send_list`	Отправка интерактивного списка/меню
`send_button`	Отправка интерактивного сообщения с кнопками
`send_status`	Публикация обновления статуса WhatsApp (истории)

Чат

Инструмент	Описание
`find_chats`	Поиск чатов, опционально с фильтрацией через `where` в стиле Prisma
`find_contacts`	Поиск контактов, опционально с фильтрацией
`find_messages`	Поиск сообщений по remoteJid с опциональным лимитом
`get_chat_history`	Получение истории сообщений для контакта или JID группы
`mark_as_read`	Отметка одного или нескольких сообщений как прочитанных
`archive_chat`	Архивация или разархивация чата
`delete_message`	Удаление сообщения для всех
`fetch_profile_picture`	Получение URL фотографии профиля контакта
`download_media`	Загрузка медиа из сообщения в формате base64
`send_presence`	Отправка статуса присутствия (печатает, записывает и т. д.)
`check_number`	Проверка наличия аккаунтов WhatsApp у номеров телефонов

Профиль

Инструмент	Описание
`fetch_business_profile`	Получение бизнес-профиля WhatsApp контакта
`update_profile_name`	Обновление отображаемого имени экземпляра
`update_profile_status`	Обновление текста «О себе»/статуса экземпляра
`update_profile_picture`	Обновление фотографии профиля экземпляра
`remove_profile_picture`	Удаление фотографии профиля экземпляра
`fetch_privacy`	Получение текущих настроек приватности
`update_privacy`	Обновление настроек приватности
`update_block_status`	Блокировка или разблокировка контакта

Группа

Инструмент	Описание
`list_groups`	Список всех групп WhatsApp для привязанного экземпляра
`get_group_info`	Получение подробной информации о конкретной группе по JID
`create_group`	Создание новой группы WhatsApp
`update_group_subject`	Обновление названия группы
`update_group_description`	Обновление описания группы
`update_group_picture`	Обновление фотографии профиля группы
`fetch_invite_code`	Получение кода приглашения/ссылки для группы
`revoke_invite_code`	Отзыв и перегенерация кода приглашения группы
`accept_invite`	Принятие приглашения в группу по коду
`send_group_invite`	Отправка ссылки-приглашения в группу конкретным контактам
`update_participants`	Добавление, удаление, повышение или понижение участников группы
`update_group_setting`	Обновление настроек группы (режим объявлений, блокировка)
`leave_group`	Выход из группы
`find_group_by_invite`	Получение информации о группе по коду приглашения без вступления

Экземпляр

Инструмент	Описание
`connection_state`	Получение текущего состояния подключения экземпляра
`restart_instance`	Перезапуск экземпляра (переподключение без выхода из системы)
`logout_instance`	Выход из экземпляра (очистка сессии)
`get_settings`	Получение текущих настроек экземпляра
`set_settings`	Обновление настроек экземпляра

Вебхук

Инструмент	Описание
`find_webhook`	Получение текущей конфигурации вебхука
`set_webhook`	Настройка вебхука

Метки

Инструмент	Описание
`find_labels`	Список всех меток (требуется WhatsApp Business)
`handle_label`	Добавление или удаление метки из чата

Установка и запуск через npx

EVOLUTION_API_URL=http://localhost:8080 \
EVOLUTION_API_KEY=your-key \
EVOLUTION_INSTANCE=your-instance \
npx mcp-evolution

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

Переменная	Обязательно	Описание
`EVOLUTION_API_URL`	Да	Базовый URL вашего Evolution API (например, `http://localhost:8080`)
`EVOLUTION_API_KEY`	Да	Глобальный ключ API из конфигурации Evolution API
`EVOLUTION_INSTANCE`	Да	Имя экземпляра, созданного в Evolution API

Скопируйте .env.example в .env для локальной разработки.

Использование с Claude Desktop / Claude Code

Добавьте в ~/.claude/claude_desktop_config.json или проектный .mcp.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["mcp-evolution"],
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "your-evolution-api-key",
        "EVOLUTION_INSTANCE": "your-instance-name"
      }
    }
  }
}

Или укажите путь напрямую к собранному бинарному файлу при запуске из локальной копии:

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-evolution/dist/index.js"],
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "your-evolution-api-key",
        "EVOLUTION_INSTANCE": "your-instance-name"
      }
    }
  }
}

Разработка

# Install dependencies
npm install

# Run in dev mode (no build step)
npm run dev

# Build TypeScript → dist/
npm run build

# Run tests
npm test

# Start from built output
npm start

Обернутые эндпоинты Evolution API

Инструмент	Метод	Путь
`send_text`	POST	`/message/sendText/{instance}`
`send_media`	POST	`/message/sendMedia/{instance}`
`send_audio`	POST	`/message/sendWhatsAppAudio/{instance}`
`send_sticker`	POST	`/message/sendSticker/{instance}`
`send_location`	POST	`/message/sendLocation/{instance}`
`send_contact`	POST	`/message/sendContact/{instance}`
`send_reaction`	POST	`/message/sendReaction/{instance}`
`send_poll`	POST	`/message/sendPoll/{instance}`
`send_list`	POST	`/message/sendList/{instance}`
`send_button`	POST	`/message/sendButtons/{instance}`
`send_status`	POST	`/message/sendStatus/{instance}`
`find_chats`	POST	`/chat/findChats/{instance}`
`find_contacts`	POST	`/chat/findContacts/{instance}`
`find_messages` / `get_chat_history`	POST	`/chat/findMessages/{instance}`
`mark_as_read`	POST	`/chat/markMessageAsRead/{instance}`
`archive_chat`	POST	`/chat/archiveChat/{instance}`
`delete_message`	DELETE	`/chat/deleteMessageForEveryone/{instance}`
`fetch_profile_picture`	POST	`/chat/fetchProfilePictureUrl/{instance}`
`download_media`	POST	`/chat/getBase64FromMediaMessage/{instance}`
`send_presence`	POST	`/chat/sendPresence/{instance}`
`check_number`	POST	`/chat/whatsappNumbers/{instance}`
`fetch_business_profile`	POST	`/chat/fetchBusinessProfile/{instance}`
`update_profile_name`	POST	`/chat/updateProfileName/{instance}`
`update_profile_status`	POST	`/chat/updateProfileStatus/{instance}`
`update_profile_picture`	POST	`/chat/updateProfilePicture/{instance}`
`remove_profile_picture`	DELETE	`/chat/removeProfilePicture/{instance}`
`fetch_privacy`	GET	`/chat/fetchPrivacySettings/{instance}`
`update_privacy`	POST	`/chat/updatePrivacySettings/{instance}`
`update_block_status`	POST	`/chat/updateBlockStatus/{instance}`
`list_groups`	GET	`/group/fetchAllGroups/{instance}`
`get_group_info`	GET	`/group/findGroupInfos/{instance}`
`create_group`	POST	`/group/create/{instance}`
`update_group_subject`	POST	`/group/updateGroupSubject/{instance}?groupJid=`
`update_group_description`	POST	`/group/updateGroupDescription/{instance}?groupJid=`
`update_group_picture`	POST	`/group/updateGroupPicture/{instance}?groupJid=`
`fetch_invite_code`	GET	`/group/inviteCode/{instance}?groupJid=`
`revoke_invite_code`	POST	`/group/revokeInviteCode/{instance}?groupJid=`
`accept_invite`	GET	`/group/acceptInviteCode/{instance}?inviteCode=`
`send_group_invite`	POST	`/group/sendInvite/{instance}`
`update_participants`	POST	`/group/updateParticipant/{instance}?groupJid=`
`update_group_setting`	POST	`/group/updateSetting/{instance}?groupJid=`
`leave_group`	DELETE	`/group/leaveGroup/{instance}?groupJid=`
`find_group_by_invite`	GET	`/group/inviteInfo/{instance}?inviteCode=`
`connection_state`	GET	`/instance/connectionState/{instance}`
`restart_instance`	POST	`/instance/restart/{instance}`
`logout_instance`	DELETE	`/instance/logout/{instance}`
`get_settings`	GET	`/settings/find/{instance}`
`set_settings`	POST	`/settings/set/{instance}`
`find_webhook`	GET	`/webhook/find/{instance}`
`set_webhook`	POST	`/webhook/set/{instance}`
`find_labels`	GET	`/label/findLabels/{instance}`
`handle_label`	POST	`/label/handleLabel/{instance}`

Требуется Evolution API v2.

Лицензия

MIT — см. LICENSE.

Отказ от ответственности

Программное обеспечение сообщества, не связанное с Evolution API или какой-либо организацией WhatsApp.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

mcp-zap
Communication App Automation
Joaquim-Salles
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.
Updated 3 months ago (2026-05-09 22:12 UTC)
mcp-evolution-api
Communication Customer Support
pauloFroes
F
license
A
quality
D
maintenance
MCP server that wraps the Evolution API (WhatsApp) as semantic tools for LLM agents, enabling messaging, chat management, group operations, and instance control via natural language.
Updated 6 months ago (2026-03-02 17:10 UTC)
32
Evolution MCP Server
Communication Developer Tools
MatheusLarcher
F
license
Not graded
quality
D
maintenance
MCP server for managing WhatsApp instances and sending messages through Evolution API.
Updated 10 months ago (2025-10-08 13:02 UTC)
1
MCP-WHATSAPP-EVO
Communication Social Media
jppeiro90
A
license
C
quality
C
maintenance
Exposes the full WhatsApp API via Evolution API, enabling message sending, chat history, group management, and more through MCP tools.
Updated 2 months ago (2026-06-30 02:47 UTC)
70
MIT

View all related MCP servers

Related MCP Connectors

omnidim-mcp-server
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
mcp-aichat
MCP server for AI dialogue using various LLM models via AceDataCloud
vonage-documentation-mcp
MCP server for Vonage API documentation, code snippets, tutorials, and troubleshooting.

View all MCP Connectors

Appeared in Searches

WhatsApp MCP (Model Context Protocol) Integration

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/billyfranklim1/mcp-evolution'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-evolution

Архитектура

Инструменты

Сообщения

Чат

Профиль

Группа

Экземпляр

Вебхук

Метки

Установка и запуск через npx

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

Использование с Claude Desktop / Claude Code

Разработка

Обернутые эндпоинты Evolution API

Лицензия

Отказ от ответственности

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

mcp-zap

mcp-evolution-api

Evolution MCP Server

MCP-WHATSAPP-EVO

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API