WhatsApp MCP 助手（客户端-服务器）

此项目构建了一个客户端-服务器管道来通过自然语言发送和安排WhatsApp消息。服务器使用Mistral的大语言模型解释用户意图，并调用Twilio实际执行WhatsApp messaging。

文件

• mcp_server.py：主要的MCP服务器文件，使用Mistral进行意图解析并调用Twilio发送消息。
• mcp_client.py：简单的CLI客户端，用于通过自然语言与服务器交互。
• config.py：存储API密钥和常量，包括电话号码配置。

服务器-客户端理念

服务器 使用Mistral的大语言模型解析用户的意图，并将其转换为可执行的指令（如发送消息）。客户端 是一个CLI界面，用户可以输入类似“向Nir发送消息”的提示，后端自动处理后续操作。

Twilio:

Twilio提供了可编程的WhatsApp消息API。在此项目中用于实际发送消息或模拟WhatsApp上的调度。

⚠️ WhatsApp 24小时窗口限制（Twilio）

如果您使用的是Twilio的WhatsApp API，请注意：自由形式的消息（即普通文本消息）仅在用户上次与您的WhatsApp号码通信后的24小时内允许发送。

如果尝试在此窗口之外发送消息，您会在Twilio仪表板上看到此错误：“无法发送自由形式消息，因为您处于不允许的时间窗口之外。如果您使用WhatsApp，请使用消息模板”。

✅ 解决方法：

• 必须使用一个预批准的消息模板来发送24小时窗口之外的消息。
• 您可以在Twilio控制台 > 消息 > 模板中创建消息模板。

💡 本地测试时：

如果您只是在自己的号码上进行测试并遇到问题，请确保您最近已经从您的WhatsApp发送消息到Twilio号码——这会重置24小时窗口。

MCP理念:

MCP服务器封装了一个功能调用能力的大语言模型（Mistral），以动态将用户意图路由到适当的工具（发送/安排WhatsApp消息）。客户端允许基于提示的CLI输入。

运行方法

1. 安装依赖项：

   pip install twilio requests fastapi
   

2. 更新 config.py 为真实值。

3. 运行服务器：

   python mcp_server.py
   

4. 在另一个终端中运行客户端：

   python mcp_client.py