WhatsApp消息发送服务

WAHA MCP服务器

MCP 服务器用于使用 WaHa 在 WhatsApp 上发送消息。

先决条件

• Docker（见上文）
• Waha局部滚动
• 用于测试的 MCP 客户端（Cursor、Claude Desktop、MCP Inspector）

Docker para Mac（苹果硅-ARM/M1/M2）

如果您使用的是配备 ARM 处理器 （Apple Silicon， M1/M2） 的 Mac，请使用 ARM 特定映像：

docker pull devlikeapro/waha:arm
docker tag devlikeapro/waha:arm devlikeapro/waha

然后，通常旋转容器（参见下一步）。

有关详细信息，请参阅 WaHa官方文件.

1.苏巴沃哈

docker run -it --rm -p 3000:3000/tcp --name waha devlikeapro/waha

• 打开仪表板：http://localhost:3000/dashboard
• 启动默认会话（ N）default） 并使用 WhatsApp 进行 QR 码验证。

2. 安装项目依赖关系

创建虚拟环境（可选，但推荐）：

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate    # Windows

安装依赖关系 ：

pip install "mcp[cli]" httpx

3. 设置联系人

创建和编辑文件 contatos.txt 在项目的根部，每行一个所需的联系人，格式：

Nome;556299999999@c.us

例如：

Jonas;556299999999@c.us
Alexandre;556299999998@c.us
Alex;556299999997@c.us

4. 将工具添加到 Claude Desktop

一步一步地将WAHA的mcp服务器集成到Claude Desktop

1. 打开菜单 克劳德 在屏幕顶部，然后选择 设置。..

2. 在左侧菜单中，单击 开发者.

3. Clique em 编辑配置 在左下角。

4. 打开文件 claude_desktop_config.json 并找到（或创建）该部分 mcpServers.

5. 添加（或编辑）以下WAHA服务器配置：

{
  "mcpServers": {
    "waha": {
      "command": "/Users/andre/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/andre/dev/tsia/waha-mcp",
        "run",
        "waha.py"
      ]
    }
  }
}

• 如果需要，请确保根据您的环境调整路径。

6. 保存文件并重新启动 Claude Desktop。

5. 在 Claude Desktop 或 MCP Inspector 中进行测试

下面是Claude Desktop中使用流程的视觉步骤：

5.1。查看可用的 MCP 服务器

5.2。查看 WAHA 服务器上可用的工具

5.3。访问资源时添加联系人

5.4。无法向联系人发送消息

5.5。允许执行命令（ 如果系统要求）

5.6。查看与 Claude 对话的最终结果

评论

• WaHa 必须运行并进行身份验证才能发送 。
• 号码必须传递 没有+符号 并以结束 @c.us.
• 您可以编辑文件 contatos.txt 任何时候。

参考资料

• WaHa快速入门
• MCP Python SDK