Skip to main content
Glama
imtaqin

waxum-mcp

by imtaqin

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),然后将此服务器指向该已配对的会话。

工具

Tool

Does

send_message

发送文本消息

send_file

发送本地文件(图片/视频/音频/文档/贴纸),类型根据 mimetype 自动检测

get_messages

读取聊天的最近历史,或按关键字搜索——包括发送者 push_name 和媒体指针

download_media

将消息的媒体下载到本地磁盘,返回文件路径

list_groups

列出此会话所在的群组,包含 JID 和成员

list_chats

按名称、电话或 push_name 列出/搜索已知联系人

session_status

检查连接/登录状态

Related MCP server: mcp-wacli

配置

有两种方式将此服务器指向 waxum,由 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(绝不会转发到 stdout,后者保留给 MCP 协议通道)。

生成模式默认在 <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
F
license - not found
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    An MCP server that enables interaction with WhatsApp using the Baileys library and Streamable HTTP transport. It supports managing contacts, chats, and messages, while providing a web admin UI for QR code authentication and media handling.
    28
    5
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps the wacli tool to enable AI clients to read, search, and send WhatsApp messages through a personal account. It provides comprehensive tools for managing chats, groups, and contacts using an existing authenticated WhatsApp session.
    27
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A self-hosted MCP server that connects AI clients to WhatsApp via the WAHA HTTP API. It enables users to manage sessions, search contacts, and send or receive messages and media directly through natural language interfaces.
    21
  • A
    license
    Not graded
    quality
    B
    maintenance
    A WhatsApp Web MCP server that enables reading chats, contacts, and messages, as well as sending, replying, reacting, and managing WhatsApp messages via stdio.
    65
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.

  • Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

  • MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/imtaqin/waxum-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server