Mcpwhatsapp

🚀 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
   

✨ 主要特性

• 构建了客户端 - 服务器管道，支持通过自然语言发送和安排WhatsApp消息。
• 服务器利用Mistral大语言模型解析用户意图，调用Twilio执行消息操作。
• 提供简单的CLI客户端，方便用户通过自然语言与服务器交互。

📦 安装指南

依赖安装

运行以下命令安装所需依赖：

pip install twilio requests fastapi

配置更新

将 config.py 文件中的相关值更新为真实值。

启动服务

1. 启动服务器：

python mcp_server.py

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

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小时窗口。