waxum-mcp
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 |
| 发送文本消息 |
| 发送本地文件(图片/视频/音频/文档/贴纸),类型根据 mimetype 自动检测 |
| 读取聊天的最近历史,或按关键字搜索——包括发送者 push_name 和媒体指针 |
| 将消息的媒体下载到本地磁盘,返回文件路径 |
| 列出此会话所在的群组,包含 JID 和成员 |
| 按名称、电话或 push_name 列出/搜索已知联系人 |
| 检查连接/登录状态 |
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 buildThis server cannot be installed
Maintenance
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
- AlicenseBqualityCmaintenanceAn 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.285MIT
- AlicenseNot gradedqualityBmaintenanceA WhatsApp Web MCP server that enables reading chats, contacts, and messages, as well as sending, replying, reacting, and managing WhatsApp messages via stdio.653MIT
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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