WhatsApp MCP Server (TypeScript/Baileys)
Сервер для интеграции WhatsApp с AI: поиск сообщений, контактов, чатов и отправка текстов через личный аккаунт.
Описание
Это MCP-сервер на TypeScript с библиотекой Baileys для подключения личного WhatsApp-аккаунта к AI-агентам (Claude, Cursor). Позволяет искать контакты, сообщения, чаты, получать историю и отправлять тексты. Данные хранятся локально в SQLite, аутентификация через QR-код. Технологии: Node.js, Pino для логов, Zod для валидации. Применения: автоматизация общения, анализ переписки в AI-интерфейсах.
Возможности
Поиск контактов
Поиск контактов по имени или номеру (JID) с возвратом идентификаторов.
Список сообщений
Получение истории сообщений для чата с пагинацией.
Список чатов
Перечисление чатов с сортировкой, фильтрацией и пагинацией, включая детали последнего сообщения.
Детали чата
Получение подробной информации о конкретном чате.
Контекст сообщения
Извлечение сообщений до и после указанного ID для контекста.
Отправка сообщений
Отправка текстовых сообщений в чаты или группы по JID.
Установка
- Клонируйте репозиторий:
git clone <your-repo-url> whatsapp-mcp-ts && cd whatsapp-mcp-ts. - Установите зависимости:
npm install(требуется Node.js >=23.10.0). - Запустите сервер:
node src/main.ts(первый запуск сгенерирует QR-код для сканирования в WhatsApp). Для AI-клиента (Claude/Cursor) настройте JSON-конфиг с командойnode {{PATH_TO_REPO}}/src/main.tsв директории клиента и перезапустите приложение.