WhatsApp MCP Assistant (Client-Server)

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：

Twilio は、プログラムから利用できる WhatsApp メッセージング API を提供します。ここでは、WhatsApp メッセージの送信や予約のシミュレーションに使用します。

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

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

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

✅ 解決方法：

• 24時間の時間枠を過ぎてから送信するメッセージには、事前承認済みのメッセージテンプレートを使用する必要があります。
• テンプレートは Twilio コンソール > Messaging > Templates で作成できます。

💡 ローカルテストの場合：

自分の番号でテストしていて送信に失敗する場合は、最近、自分の 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