WhatsApp MCP Server

WhatsApp MCP サーバー

Model Context Protocol（MCP）SDK を使用した WhatsApp サーバーの実装です。このサーバーは、GreenAPI サービスを通じて WhatsApp とやり取りするための標準化されたインターフェースを提供します。

機能

• WhatsApp セッション管理
• GreenAPI サービスとの統合
• 標準化された MCP プロトコルの実装
• TypeScript のサポート

前提条件

• Node.js（v14 以降）
• npm または yarn
• GreenAPI アカウントと認証情報

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd whatsapp-mcp-server

2. 依存関係をインストールします：

npm install

設定

サーバーには、次の環境変数が必要です：

• GREENAPI_API_URL：GreenAPI サービスのベース URL
• GREENAPI_API_TOKEN：GreenAPI API トークン

使用方法

1. サーバーを起動します：

npm start

2. サーバーは標準入力／出力を通じて MCP プロトコルのメッセージを待ち受けます。

利用可能なツール

セッションを開く

GreenAPI の認証情報を使用して、新しい WhatsApp セッションを開きます。

パラメーター：

• sessionId：一意のセッション ID
• instanceId：GreenAPI インスタンス ID
• apiTokenInstance：GreenAPI API トークン

メッセージを送信

指定したチャットにメッセージを送信します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• chatId：送信先のチャット ID（例：[email protected] または [email protected]）
• message：送信するメッセージ

チャット一覧を取得

利用可能なチャットの一覧を取得します。

パラメーター：

• sessionId：open_session で開いたセッション ID

グループを作成

新しい WhatsApp グループを作成します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• groupName：作成するグループの名前
• participants：ドメインを含む電話番号の配列（例：[email protected]）

チャット履歴を取得

指定したチャット（個人またはグループ）の最近のメッセージを取得します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• chatId：メッセージを取得するチャット ID（例：[email protected] または [email protected]）
• count：取得するメッセージ数（デフォルト：50）

Important：チャット履歴で受信メッセージを取得するには、SetSettings メソッドまたは GreenAPI コンソールを使って、「Receive webhooks on incoming messages and files」設定を有効にする必要があります。この設定を有効にしない場合、チャット履歴には送信メッセージのみが表示されます。

ファイルを送信

指定したチャットにファイルを送信します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• chatId：WhatsApp チャット ID（例：[email protected]）
• fileUrl：送信するファイルの公開 URL
• fileName：（任意）受信者に表示されるファイル名
• caption：（任意）ファイルの下に表示するキャプション

参加者を追加

既存の WhatsApp グループに参加者を追加します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• groupId：WhatsApp グループの ID（例：[email protected]）
• participantChatId：追加する参加者のチャット ID（例：[email protected]）

参加者を削除

既存の WhatsApp グループから参加者を削除します。

パラメーター：

• sessionId：open_session で開いたセッション ID
• groupId：WhatsApp グループの ID（例：[email protected]）
• participantChatId：削除する参加者のチャット ID（例：[email protected]）