Scan to contactarticle
README
🚀 WhatsApp MCP 助手（客户端 - 服务器）
本项目搭建了一套客户端 - 服务器管道，可通过自然语言实现WhatsApp消息的发送与安排。服务器借助Mistral大语言模型解读用户意图，并调用Twilio来实际执行WhatsApp消息的相关操作。
🚀 快速开始
运行步骤
-
安装依赖项：
pip install twilio requests fastapi -
更新
config.py为真实值。 -
运行服务器：
python mcp_server.py -
在另一个终端中运行客户端：
python mcp_client.py
✨ 主要特性
- 构建了客户端 - 服务器管道，支持通过自然语言发送和安排WhatsApp消息。
- 服务器利用Mistral大语言模型解析用户意图，调用Twilio执行消息操作。
- 提供简单的CLI客户端，方便用户通过自然语言与服务器交互。
📦 安装指南
依赖安装
运行以下命令安装所需依赖：
pip install twilio requests fastapi
配置更新
将 config.py 文件中的相关值更新为真实值。
启动服务
- 启动服务器：
python mcp_server.py
- 在另一个终端启动客户端：
python mcp_client.py
📚 详细文档
文件说明
mcp_server.py：核心的MCP服务器文件，运用Mistral进行意图解析，并调用Twilio发送消息。mcp_client.py：简易的CLI客户端，用于用户通过自然语言与服务器进行交互。config.py：用于存储API密钥和常量，包含电话号码的配置信息。
服务器 - 客户端理念
- 服务器：借助Mistral大语言模型解析用户意图，并将其转化为可执行的指令，如发送消息等操作。
- 客户端：提供一个CLI界面，用户可输入类似“向Nir发送消息”的提示，后端会自动处理后续操作。
Twilio说明
Twilio提供了可编程的WhatsApp消息API，本项目使用该API来实际发送消息或模拟WhatsApp上的调度功能。
MCP理念
MCP服务器封装了具备功能调用能力的大语言模型（Mistral），能够动态地将用户意图路由到合适的工具（发送/安排WhatsApp消息）。客户端支持基于提示的CLI输入。
⚠️ 重要提示
如果您使用的是Twilio的WhatsApp API，请注意：自由形式的消息（即普通文本消息）仅在用户上次与您的WhatsApp号码通信后的24小时内允许发送。
若尝试在此窗口之外发送消息，您会在Twilio仪表板上看到此错误：“无法发送自由形式消息，因为您处于不允许的时间窗口之外。如果您使用WhatsApp，请使用消息模板”。
✅ 解决方法
- 必须使用一个预批准的消息模板来发送24小时窗口之外的消息。
- 您可以在Twilio控制台 > 消息 > 模板中创建消息模板。
💡 使用建议
如果您只是在自己的号码上进行测试并遇到问题，请确保您最近已经从您的WhatsApp发送消息到Twilio号码——这会重置24小时窗口。