WhatsApp MCP Assistant (Client-Server)

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

本项目构建了一个客户端-服务端工作流，通过自然语言发送和安排 WhatsApp 消息。服务端使用 Mistral 的 LLM 解读用户意图，并使用 Twilio 实际发送 WhatsApp 消息。

文件

• mcp_server.py：主要的 MCP 服务，使用 Mistral 解读用户输入，并调用 Twilio 发送消息。
• mcp_client.py：简单的命令行客户端，可通过自由格式的自然语言与服务端交互。
• config.py：存储 API 密钥和常量，包括电话号码配置。

客户端-服务端设计

服务端使用 Mistral 的 LLM 解析你的意图，并将其转换为可执行指令（例如发送消息）。客户端是一个命令行界面，你可以在其中输入“给 Nir 发消息”之类的提示词，后端会处理其余工作。

Twilio：

Twilio 提供可编程的 WhatsApp 消息 API。这里使用它来发送消息，或模拟通过 WhatsApp 安排发送。

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

如果你使用 Twilio 的 WhatsApp API，请注意，只有在用户上次向你的 WhatsApp 号码发送消息后的 24 小时窗口 内，才允许发送自由格式消息（即普通文本消息）。

如果你尝试在该窗口之外发送消息，会在 Twilio 控制面板中看到以下错误： “无法发送自由格式消息，因为你不在允许的时间窗口内。如果你使用 WhatsApp，请使用消息模板。”

✅ 解决方法：

• 超过 24 小时窗口后发送消息，必须使用预先批准的消息模板。
• 你可以在 Twilio 控制台 > Messaging > Templates 中创建模板。

💡 本地测试：

如果你只是在用自己的号码测试，但发送失败，请确保你最近曾通过自己的 WhatsApp 向 Twilio 号码发送过消息——这会重置 24 小时窗口。

MCP 设计：

MCP 服务封装了一个支持函数调用的大模型（Mistral），可将用户意图动态路由到相应工具（发送/安排 WhatsApp 消息）。客户端允许通过命令行输入提示词。

运行方法

1. 安装依赖：

   pip install twilio requests fastapi
   

2. 使用真实值更新 config.py。

3. 运行服务端：

   python mcp_server.py
   

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

   python mcp_client.py