WhatsApp MCP Assistant (Client-Server)

基本能力

产品定位

MCPWhatsApp 是一个 WhatsApp 消息自动化工具，旨在通过自然语言处理技术简化消息发送和调度流程。

核心功能

1. 自然语言解析：使用 Mistral 的 LLM 技术解析用户输入的自然语言意图。
2. 消息发送：通过 Twilio 的 WhatsApp API 发送消息。
3. 消息调度：支持消息的定时发送（需注意 Twilio 的 24 小时窗口限制）。
4. 客户端交互：提供 CLI 客户端，支持自由格式的自然语言输入。

适用场景

1. 个人自动化：自动化发送 WhatsApp 消息给联系人。
2. 团队协作：批量发送消息或提醒给团队成员。
3. 客户服务：用于客户支持或通知发送。

工具列表

1. mcp_server.py：主服务器，负责解析用户意图并调用 Twilio API 发送消息。
2. mcp_client.py：命令行客户端，用于与服务器交互。
3. config.py：存储 API 密钥和配置信息。

常见问题解答

1. 24 小时窗口限制：Twilio 的 WhatsApp API 仅允许在用户最后一次发送消息后的 24 小时内发送自由格式消息。超出此窗口需使用预批准的模板消息。
2. 本地测试：确保在测试时已向 Twilio 号码发送过消息以重置 24 小时窗口。

使用教程

使用依赖

安装所需依赖：

pip install twilio requests fastapi

安装教程

1. 克隆项目或下载源代码。
2. 更新 config.py 文件中的 API 密钥和配置信息。
3. 启动服务器：

python mcp_server.py

1. 在另一个终端中启动客户端：

python mcp_client.py

调试方式

1. 确保服务器已正确启动并监听指定端口。
2. 使用客户端发送测试消息，检查服务器日志以确认消息是否被正确解析和发送。
3. 如遇 Twilio API 错误，检查 API 密钥和 24 小时窗口限制。

许可证

该项目遵循 None 开源许可条款。