waxum-mcp

WhatsApp 用の MCP サーバーで、waxum REST API ゲートウェイをバックエンドとしています。stdio 経由で任意の MCP クライアント（Claude Desktop、Claude Code など）に送信・読み取り・メディアのツールを公開します。

waxum >= 0.11.5 が必要です（GET /messages/chat/{chat_jid} が必要）。

セッションペアリング（QR / 電話番号リンク）はこのサーバーの対象外です。 先に waxum に対して直接セッションをペアリングし（独自コンソールまたは POST /sessions/{id}/pair）、その後このサーバーをそのペアリング済みセッションに向けてください。

ツール

Related MCP server: mcp-wacli

設定

このサーバーを waxum に向ける方法は 2 つあり、WAXUM_MODE で選択します（または 自動検出: WAXUM_BASE_URL が設定されている場合は client、それ以外は 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

スポーンモード — このサーバーが 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

スポーンモードでは、トークンは生成されたプロセスの SUPERADMIN_TOKEN 環境変数になります — waxum 自身のブートストラップ資格情報です — そのため、 事前にトークンを発行する必要はありません。子プロセスの stdout と stderr はこのサーバーの stderr に転送されます（MCP プロトコルチャネル用に予約されている stdout には決して送られません）。

スポーンモードはデフォルトで <WAXUM_WORKDIR>/waxum.db の SQLite を使用し、 MCP サーバーをゼロ設定で再起動安全に保ちます。必要に応じて WAXUM_DATABASE_URL を 明示的な sqlite:// パス、PostgreSQL URL、または MySQL URL に設定してください。

開発

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