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

本项目搭建了一套客户端 - 服务器管道，可借助自然语言实现WhatsApp消息的发送与安排。服务器运用Mistral大语言模型解读用户意图，再调用Twilio来实际执行WhatsApp消息的发送操作。

🚀 快速开始

运行步骤

1. 安装依赖项：

   pip install twilio requests fastapi
   

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

3. 运行服务器：

   python mcp_server.py
   

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

   python mcp_client.py
   

✨ 主要特性

• 借助Mistral大语言模型解析用户意图，将自然语言转化为可执行指令。
• 客户端提供CLI界面，方便用户通过自然语言与服务器交互。
• 利用Twilio的可编程WhatsApp消息API，实现消息的发送与调度。

📦 安装指南

依赖安装

pip install twilio requests fastapi

配置文件更新

更新 config.py 文件，填入真实的API密钥和常量，包括电话号码配置。

📚 详细文档

文件说明

服务器 - 客户端理念

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

Twilio说明

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

MCP理念

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

⚠️ 重要提示

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

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

✅ 解决方法

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

💡 使用建议

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