Mcpwhatsapp

🚀 WhatsApp MCP 助手（クライアント - サーバ）

このプロジェクトは、自然言語でWhatsAppメッセージを送信およびスケジュールするためのクライアント - サーバパイプラインを構築しています。サーバはMistralの大規模言語モデルを使用してユーザーの意図を解釈し、Twilioを呼び出して実際にWhatsAppメッセージングを実行します。

📄 文件

• mcp_server.py：主要なMCPサーバファイルで、Mistralを使用して意図を解析し、Twilioを呼び出してメッセージを送信します。
• mcp_client.py：自然言語でサーバとやり取りするためのシンプルなCLIクライアントです。
• config.py：APIキーや定数、電話番号の設定を保存します。

🔌 サーバ - クライアントの概念

サーバ はMistralの大規模言語モデルを使用してユーザーの意図を解析し、それを実行可能な命令（メッセージの送信など）に変換します。クライアント はCLIインターフェースで、ユーザーは「Nirにメッセージを送る」などのプロンプトを入力でき、バックエンドが自動的に後続の操作を処理します。

Twilio:

TwilioはプログラマブルなWhatsAppメッセージAPIを提供しています。このプロジェクトでは、実際のメッセージ送信やWhatsApp上のスケジューリングのシミュレーションに使用されます。

⚠️ WhatsApp 24時間ウィンドウ制限（Twilio）

TwilioのWhatsApp APIを使用する場合は、以下に注意してください。自由形式のメッセージ（通常のテキストメッセージ） は、ユーザーが最後にあなたのWhatsApp番号と通信してから24時間以内にのみ送信できます。

このウィンドウ外でメッセージを送信しようとすると、Twilioダッシュボードに次のエラーが表示されます。「自由形式のメッセージを送信できません。許可されていない時間ウィンドウ外にいるためです。WhatsAppを使用する場合は、メッセージテンプレートを使用してください」。

✅ 解決策：

• 24時間ウィンドウ外のメッセージを送信するには、事前承認されたメッセージテンプレート を使用する必要があります。
• メッセージテンプレートはTwilioコンソール > メッセージ > テンプレートで作成できます。

💡 ローカルテスト時：

自分の番号でテストして問題が発生した場合は、最近自分のWhatsAppからTwilio番号にメッセージを送信したこと を確認してください。これにより24時間ウィンドウがリセットされます。

MCPの概念:

MCPサーバは、機能呼び出し機能を持つ大規模言語モデル（Mistral）をカプセル化し、ユーザーの意図を適切なツール（WhatsAppメッセージの送信/スケジューリング）に動的にルーティングします。クライアントはプロンプトベースのCLI入力を許可します。

🚀 実行方法

1. 依存関係をインストールします。

   pip install twilio requests fastapi
   

2. config.py を実際の値に更新します。

3. サーバを起動します。

   python mcp_server.py
   

4. 別のターミナルでクライアントを起動します。

   python mcp_client.py