WhatsApp MCP サーバー
概要
WhatsApp MCP（Model Context Protocol）サーバーは、macOS上のWhatsAppデスクトップアプリケーションとのプログラム的な連携を可能にするNode.jsアプリケーションです。AppleScriptの自動化機能を使用することで、WhatsApp UIを直接操作することなく、メッセージの送信やWhatsAppのステータス確認のためのシンプルなインターフェースを提供します。
Related MCP server: WhatsApp Web MCP
特徴
1. 連絡先にメッセージを送信する
WhatsApp の連絡先リスト内の特定の連絡先にテキスト メッセージを送信します。
メッセージは接続されたWhatsAppデスクトップアプリケーションを通じて配信されます
改行を含むメッセージの適切なフォーマットをサポートします
AppleScriptを使用してWhatsAppデスクトップインターフェースを自動化します
2. WhatsAppのステータスを確認する（WIP）
WhatsApp アプリケーションが現在実行されているかどうかを確認します。
WhatsAppの現在の実行ステータスを返します
メッセージを送信する際のエラーを防ぐのに役立ちます
3. 最近の連絡先を一覧表示する（WIP）
WhatsApp のプライバシー保護のため、この機能は機能が制限されています。
WhatsAppのプライバシー制限についてユーザーに通知
メッセージには正確な連絡先名が必要です
技術的実装
構築済み
@modelcontextprotocol/sdk - MCP サーバーと stdio トランスポート
Zod - スキーマ検証
Node.js 組み込みモジュール (child_process、util、fs)
macOS自動化のためのAppleScript
建築
標準化されたツール通信にモデルコンテキストプロトコル（MCP）を使用します
通信にはstdioトランスポートを採用
WhatsAppデスクトップアプリケーションと対話するためのAppleScriptコマンドを実行します
デバッグのための包括的なエラーログを実装します
要件
macOSオペレーティングシステム
WhatsAppデスクトップアプリケーションがインストールされている
Node.js v14.0.0 以上
インターネット接続
インストール
使用法
サーバーの起動
クロードとの統合
Claude が WhatsApp MCP サーバーを使用できるようにするには、次の手順に従います。
MCPサーバーをセットアップする
上記の説明に従ってWhatsApp MCPサーバーをインストールして構成します
ローカルマシン上でサーバーが正常に動作していることを確認します
MCPツールでClaude Desktopを構成する
claude_desktop_config.jsonファイルを変更して WhatsApp MCP ツールを追加します。このファイルは通常、Claude Desktopアプリケーションの構成ディレクトリにあります。
WhatsApp MCP ツールを登録するには、次の構成を追加します。
統合をテストする
クロードとのテスト会話を作成する
クロードにテスト連絡先にWhatsAppメッセージを送信するよう依頼する
WhatsAppデスクトップアプリからメッセージが正常に送信されたことを確認します
利用可能なMCPツール
1. WhatsAppメッセージを送信する
指定された WhatsApp 連絡先にメッセージを送信します。
パラメータ:
contactName: WhatsAppに表示される連絡先のフルネームmessage: 送信するメッセージの内容
使用例（MCP クライアント経由）:
2. WhatsAppのステータスを確認する
WhatsApp アプリケーションが現在実行されているかどうかを確認します。
パラメータは必要ありません。
使用例（MCP クライアント経由）:
3. 最近の連絡先の一覧
WhatsApp の連絡先リストに関するプライバシー制限に関する情報を提供します。
パラメータは必要ありません。
使用例（MCP クライアント経由）:
実装の詳細
AppleScriptの自動化
サーバーは AppleScript を使用して WhatsApp デスクトップ アプリケーションを自動化します。
WhatsAppアプリケーションを起動します
キーボードショートカットを使用してインターフェースを操作します
名前で連絡先を検索します
下矢印ナビゲーションを使用して連絡先を選択します
メッセージを入力して送信する
エラー処理
包括的なエラー処理とログ記録:
コンソールエラー出力
~/Library/Logs/whatsapp-mcp/のファイルベースのログAppleScript実行エラーの適切な処理
プロセスレベルの例外処理
クロードとWhatsApp MCPツールを使用する
WhatsApp MCP ツールを Claude と統合すると、自然言語を使用して Claude に次の指示を出すことができます。
メッセージを送信
プロンプトの例:
「ジョンにWhatsAppメッセージを送って、会議に10分遅れる旨を伝えてください」
WhatsAppでサラに次のテキストを送信してください: これがあなたが要求した文書です。
「WhatsAppでお母さんに『お誕生日おめでとう！』と送ろう」
WhatsAppのステータスを確認する
プロンプトの例:
「私のコンピューターでWhatsAppは実行されていますか？」
「WhatsAppがアクティブかどうかを確認してください」
「メッセージを送信する前にWhatsAppのステータスを確認してください」
連絡先情報を取得する
プロンプトの例:
「最近のWhatsAppの連絡先をリストしてもらえますか？」
「WhatsAppで最近メッセージを送った相手を表示」
Claude はお客様のリクエストに基づいて適切な MCP ツールを使用して、結果に関するフィードバックを提供します。
制限事項
AppleScript に依存しているため、macOS でのみ動作します
WhatsAppデスクトップアプリケーションのインストールが必要です
WhatsApp UIの変更により連絡先の選択が影響を受ける可能性があります
プライバシー保護のため、WhatsAppの連絡先リストへのアクセスが制限される
ローカルの MCP ツールにアクセスするには、Claude を適切に構成する必要があります。
セキュリティに関する考慮事項
サーバーは個人のWhatsAppアカウントとやり取りします
メッセージはあなたのアカウントから送信され、あなたが送信したように表示されます
信頼できる環境でのみ使用してください
ライセンス
マサチューセッツ工科大学
免責事項
このプロジェクトは、WhatsApp Inc. または Meta Platforms, Inc. と提携していません。ご自身の判断で WhatsApp の利用規約に従って使用してください。