MCP WhatsApp Server
2025.04.22
0
PythonWhatsApp 集成消息自动化交流协作
MCP WhatsApp Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于通过 Waha API 与 WhatsApp 进行集成。该项目允许兼容 MCP 的 AI 助手（如 Claude）直接与 WhatsApp 联系人进行交互。
View on GitHub
Overview
基本能力
产品定位
MCP WhatsApp Server 是一个用于集成 WhatsApp 通信的 MCP 服务器，主要功能是通过 Waha API 实现与 WhatsApp 的交互。
核心功能
- 验证 WhatsApp 连接状态
- 通过电话号码发送消息
- 通过已注册的联系人名称发送消息
- 按名称管理联系人
- 查看服务器配置
适用场景
- AI 助手通过 WhatsApp 与用户进行通信
- 自动化 WhatsApp 消息发送
- 联系人管理
工具列表
verificar_conexao_whatsapp()- 检查当前连接状态enviar_mensagem_whatsapp(numero, mensagem)- 通过电话号码发送消息
常见问题解答
无明确常见问题解答部分。
使用教程
使用依赖
- Python 3.7+
- 运行的 Waha API
- MCP 库 (Fast MCP)
安装教程
-
克隆仓库:
bash git clone https://github.com/seu-usuario/mcp-whatsapp-server.git cd mcp-whatsapp-server -
安装依赖:
bash pip install -r requirements.txt -
在
.env文件中配置环境变量:WAHA_API_URL=http://localhost:3000 WAHA_SESSION_ID=default CONTATOS_FILE=caminho/para/contatos.json (可选) -
在
contatos.json文件中配置联系人:json { "contatos": { "Nome1": "5511999999999", "Nome2": "5522888888888" } }
调试方式
-
按照官方说明启动 Waha API
-
运行 MCP 服务器:
bash python server.py -
使用兼容的 MCP 客户端（如 Claude Desktop）与服务器交互