waxum-mcp

MCP-сервер для WhatsApp, работающий на основе REST API-шлюза waxum. Предоставляет инструменты отправки/чтения/медиа любому MCP-клиенту (Claude Desktop, Claude Code и т.д.) через stdio.

Требуется waxum >= 0.11.5 (нужен GET /messages/chat/{chat_jid}).

Сопряжение сессии (QR / привязка по номеру телефона) не является частью этого сервера — сначала выполните сопряжение сессии напрямую с waxum (через его собственную консоль или POST /sessions/{id}/pair), затем укажите этому серверу на уже сопряжённую сессию.

Инструменты

Related MCP server: mcp-wacli

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

Два способа указать этому серверу на waxum, выбирается с помощью WAXUM_MODE (или автоматически: client, если задан WAXUM_BASE_URL, иначе spawn).

Клиентский режим — waxum уже запущен где-то ещё

WAXUM_MODE=client
WAXUM_BASE_URL=http://localhost:3451
WAXUM_TOKEN=<superadmin token or a session token>
WAXUM_SESSION_ID=<the session to operate on>
WAXUM_MEDIA_DIR=./media   # optional, default ./media

Режим spawn — этот сервер управляет процессом waxum

WAXUM_MODE=spawn
WAXUM_BINARY_PATH=/path/to/waxum
WAXUM_WORKDIR=/path/to/waxum/data   # optional, default: binary's directory
WAXUM_PORT=3451                     # optional, default 3451
WAXUM_TOKEN=<superadmin token>      # optional, a random one is generated if unset
WAXUM_SESSION_ID=<the session to operate on>
WAXUM_DATABASE_URL=sqlite:///data/waxum.db # optional

В режиме spawn токен становится переменной окружения SUPERADMIN_TOKEN запущенного процесса — собственным начальным учётным данным waxum — поэтому токен не нужно создавать заранее. Стандартный вывод и поток ошибок дочернего процесса перенаправляются в поток ошибок этого сервера (никогда в стандартный вывод, который зарезервирован для канала протокола MCP).

Режим spawn по умолчанию использует SQLite по адресу <WAXUM_WORKDIR>/waxum.db, что делает MCP-сервер не требующим настройки и безопасным при перезапуске. При необходимости задайте WAXUM_DATABASE_URL как явный путь sqlite://, URL PostgreSQL или URL MySQL.

Разработка

npm install
npm run dev     # run directly with tsx
npm run build   # compile to dist/
npm start       # run the compiled build