WhatsApp MCP助手(客户端-服务器)
该项目构建了一个客户端-服务器管道,使用自然语言发送和调度WhatsApp消息。服务器使用Mistral的LLM解释用户意图,并使用Twilio执行实际的WhatsApp消息传递。
文件
mcp_server.py:使用Mistral解释用户输入并调用Twilio发送消息的主MCP服务器。mcp_client.py:使用自由形式的自然语言与服务器交互的简单CLI客户端。config.py:存储API密钥和常量,包括电话号码配置。
服务器客户端理念
这 服务器 使用Mistral的LLM解析您的意图,并将其转换为可操作的指令(如发送消息)。这 客户端 是一个CLI界面,您可以在其中键入“向Nir发送消息”等提示,后端将处理其余部分。
提里奥:
Twilio提供可编程的WhatsApp消息API。它在这里用于通过WhatsApp发送消息或模拟日程安排。
⚠️ WhatsApp 24小时窗口限制(Twilio)
如果您正在使用Twilio的WhatsApp API,请注意 自由形式的消息(即常规文本消息) 只允许在a内 24小时窗口 在用户最后一次发送您的WhatsApp号码后。
如果您尝试在该窗口外发送消息,您将在Twilio仪表板中看到此错误: 无法发送自由形式的消息,因为您在允许的窗口之外。如果您使用的是WhatsApp,请使用消息模板
✅ 要解决此问题,请执行以下操作:
- 您必须使用 预先批准的消息模板 对于24小时窗口后发送的消息。
- 您可以在 Twilio控制台>消息>模板.
💡 对于本地测试:
如果你只是用自己的号码测试,但失败了,请确保你已经 最近从您自己的WhatsApp向Twilio号码发送了一条消息 --这将重置24小时窗口。
MCP理念:
MCP服务器封装了一个可调用函数的LLM(Mistral),以动态地将用户意图路由到适当的工具(发送/调度WhatsApp消息)。客户端允许基于CLI的提示输入。
如何跑步
- 安装依赖项:
pip install twilio requests fastapi- 更新
config.py具有真正的价值。
- 运行服务器:
python mcp_server.py- 在另一个终端中,运行客户端:
python mcp_client.py
