WhatsApp MCP Server
Сервер для интеграции WhatsApp с AI-агентами, позволяющий искать, читать и отправлять сообщения, включая медиа-файлы.
Описание
Это MCP-сервер для WhatsApp, подключающийся к личному аккаунту через WhatsApp Web API с использованием библиотеки whatsmeow (Go). Сообщения хранятся локально в SQLite, передаваясь AI (например, Claude) только по запросу. Ключевые особенности: поиск контактов и чатов, чтение/отправка текстов и медиа (изображения, видео, аудио, документы), поддержка FFmpeg для конвертации аудио. Применения: автоматизация общения через AI, анализ истории сообщений, интеграция в чат-боты.
Возможности
Поиск контактов
Поиск контактов по имени или номеру телефона с помощью search_contacts.
Чтение сообщений
Получение списка сообщений, чатов и контекста с фильтрами через list_messages, get_message_context.
Отправка сообщений
Отправка текстовых сообщений в чаты или группы с помощью send_message.
Работа с медиа
Отправка изображений, видео, документов и аудио через send_file и send_audio_message; скачивание медиа по message_id.
Управление чатами
Список чатов, получение информации о чате или последнем взаимодействии через list_chats, get_chat.
Установка
Предварительные требования: Go, Python 3.6+, UV (установить: curl -LsSf https://astral.sh/uv/install.sh | sh), FFmpeg (опционально для аудио).
Клонируйте репозиторий: git clone https://github.com/lharries/whatsapp-mcp.git && cd whatsapp-mcp
Запустите WhatsApp bridge: cd whatsapp-bridge && go run main.go (отсканируйте QR-код в WhatsApp для аутентификации).
Настройте MCP-сервер: Создайте JSON: { “mcpServers”: { “whatsapp”: { “command”: “{{PATH_TO_UV}}”, “args”: [ “–directory”, “{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server”, “run”, “main.py” ] } } } Для Claude: сохраните как ~/Library/Application Support/Claude/claude_desktop_config.json. Для Cursor: ~/.cursor/mcp.json.
Перезапустите Claude Desktop или Cursor.
Для Windows: Установите C-компилятор (MSYS2), включите CGO: go env -w CGO_ENABLED=1.