lharries/whatsapp-mcp

WhatsApp MCP-сервер

MCP⭐ 6 292Goпоследний релиз: v0.0.1
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

Это MCP-сервер, который подключает LLM-агентов к личному аккаунту WhatsApp для чтения, поиска и отправки сообщений и медиафайлов.

Зачем нужен

Инструмент позволяет AI-агентам (например, в Claude Desktop или Cursor) взаимодействовать с историей переписки WhatsApp через локальную SQLite-базу. Это полезно для автоматизации коммуникации, быстрого поиска информации в чатах и отправки ответов или файлов без ручного ввода.

Что можно реализовать

  • Поиск конкретных сообщений, контактов или медиафайлов в истории WhatsApp через естественный язык.
  • Автоматическая отправка текстовых сообщений, документов или медиа (изображений, видео) от имени пользователя.
  • Отправка голосовых сообщений (audio messages) с конвертацией аудиофайлов в формат Opus.
  • Получение контекста последних взаимодействий с конкретным контактом или группой.
  • Интеграция WhatsApp в рабочие процессы агентов в IDE (Cursor) или чат-интерфейсах (Claude Desktop).

Ключевые возможности

  • Прямое подключение к личному WhatsApp через Web Multidevice API (библиотека whatsmeow).
  • Локальное хранение всей истории сообщений в SQLite, данные отправляются LLM только по запросу.
  • Поддержка работы с различными типами контента: текст, изображения, видео, документы, аудио.
  • Кроссплатформенность: работает на macOS, Linux и Windows (с настройкой CGO).
  • Готовая интеграция с MCP-клиентами: Claude Desktop и Cursor.

👤 Кому подойдёт: Разработчики, использующие MCP-серверы, и пользователи, желающие интегрировать свой личный WhatsApp с AI-агентами (LLM).

Релизы

v0.0.1minor
🕐 17 мес назад · релиз на GitHub ↗

Добавлена поддержка групповых чатов, отправка и получение медиафайлов (аудио, видео, изображения), улучшена работа с датами и документация для Windows.

  • Added: Добавлена поддержка групповых чатов с отображением имен отправителей.
  • Added: Реализована отправка файлов и аудиосообщений.
  • Added: Добавлена поддержка входящих медиафайлов: изображений, видео, документов и аудио.
  • Fixed: Улучшена обработка дат.
  • Added: Добавлены инструкции по совместимости с Windows в документацию.