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
   

✨ 主要特性

• 藉助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小時窗口。