WhatsApp消息调度服务

一个基于Mistral LLM和Twilio API的客户端-服务器管道,用于通过自然语言发送和调度WhatsApp消息。

  • by Nirsisr
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Nirsisr/MCPWhatsApp

使用说明

WhatsApp MCP助手(客户端-服务器)

该项目构建了一个客户端-服务器管道,使用自然语言发送和调度WhatsApp消息。服务器使用Mistral的LLM解释用户意图,并使用Twilio执行实际的WhatsApp消息传递。

文件

  • mcp_server.py:使用Mistral解释用户输入并调用Twilio发送消息的主MCP服务器。
  • mcp_client.py:使用自由形式的自然语言与服务器交互的简单CLI客户端。
  • config.py:存储API密钥和常量,包括电话号码配置。

服务器客户端理念

这 服务器 使用Mistral的LLM解析您的意图,并将其转换为可操作的指令(如发送消息)。这 客户端 是一个CLI界面,您可以在其中键入“向Nir发送消息”等提示,后端将处理其余部分。

提里奥:

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

⚠️ WhatsApp 24小时窗口限制(Twilio)

如果您正在使用Twilio的WhatsApp API,请注意 自由形式的消息(即常规文本消息) 只允许在a内 24小时窗口 在用户最后一次发送您的WhatsApp号码后。

如果您尝试在该窗口外发送消息,您将在Twilio仪表板中看到此错误: 无法发送自由形式的消息,因为您在允许的窗口之外。如果您使用的是WhatsApp,请使用消息模板

✅ 要解决此问题,请执行以下操作:

💡 对于本地测试:

如果你只是用自己的号码测试,但失败了,请确保你已经 最近从您自己的WhatsApp向Twilio号码发送了一条消息 --这将重置24小时窗口。

MCP理念:

MCP服务器封装了一个可调用函数的LLM(Mistral),以动态地将用户意图路由到适当的工具(发送/调度WhatsApp消息)。客户端允许基于CLI的提示输入。

如何跑步

  1. 安装依赖项:

    pip install twilio requests fastapi
    
  2. 更新 config.py 具有真正的价值。

  3. 运行服务器:

    python mcp_server.py
    
  4. 在另一个终端中,运行客户端:

    python mcp_client.py