WhatsApp Messaging API

WhatsApp Messaging API — MCP 服务

从 Claude、Cursor 或任何 MCP 客户端发送 WhatsApp 消息。创建会话、扫描二维码，然后发送文本、图片和文件——无需 Meta Business 审批，也无需 WhatsApp Business 账号。

封装了 WhatsApp Messaging API。

快速开始

1. 从 RapidAPI 获取免费 API 密钥——无需信用卡。

2. 将以下内容添加到 MCP 客户端配置中（Claude Desktop：claude_desktop_config.json）：

   {
     "mcpServers": {
       "whatsapp": {
         "command": "npx",
         "args": ["-y", "whatsapp-messaging-api-mcp"],
         "env": {
           "WHATSAPP_API_KEY": "your-rapidapi-key"
         }
       }
     }
   }
   

3. 重启客户端。让它创建 WhatsApp 会话并显示二维码。

无需安装或构建任何内容——首次运行时，npx 会获取此软件包。

工具

工具	描述
list_sessions	列出此 API 密钥下的所有会话
create_session	创建新会话
get_session_status	检查会话的当前状态
get_qr_code	获取用于验证会话的二维码
request_pairing_code	获取 8 位配对码，而不是二维码
check_contact_exists	发送前检查电话号码是否已注册 WhatsApp
send_text_message	发送文本消息
send_image	通过 URL 发送图片
send_file	通过 URL 发送文件（PDF、文档）

典型流程

1. create_session → get_qr_code → 使用 WhatsApp 扫描（设置 → 已关联设备）
2. 调用 get_session_status，直到状态显示为 WORKING
3. 调用 check_contact_exists，然后调用 send_text_message / send_image / send_file

会话会在多次运行之间保持已验证状态，因此第 1-2 步每个号码只需执行一次。

配置

变量	必需	描述
WHATSAPP_API_KEY	是	你的 RapidAPI 密钥。若缺少此密钥，服务会在启动时退出。

密钥从环境变量中读取，且只会发送到 API 主机。密钥绝不会被记录到日志中。

本地开发

git clone https://github.com/jevil25/whatsapp-messaging-api-mcp.git
cd whatsapp-messaging-api-mcp
npm install
npm run dev      # runs src/index.ts directly via tsx, no build step
npm run build    # compile to dist/
npm test         # boots the built server and drives a real MCP handshake

npm test 无需凭据——它会传入一个虚拟密钥，因此能够完成工具列表查询，因为握手过程中不会调用 API。

要让 MCP 客户端连接到本地构建版本，请使用 "command": "node" 和 "args": ["/absolute/path/to/dist/index.js"]。

发布流程请参阅 DEVELOPING.md。

链接

• npm 软件包
• MCP 注册表条目 — io.github.jevil25/whatsapp-messaging-api-mcp
• WhatsApp Messaging API 文档

许可证

MIT