Integrations
Leverages macOS-specific AppleScript automation to control the WhatsApp desktop application for sending messages and checking status without direct UI interaction.
Enables programmatic interaction with the WhatsApp desktop application on macOS, allowing for sending messages to contacts and checking the application's status through AppleScript automation.
WhatsApp MCP サーバー
概要
WhatsApp MCP（Model Context Protocol）サーバーは、macOS上のWhatsAppデスクトップアプリケーションとのプログラム的な連携を可能にするNode.jsアプリケーションです。AppleScriptの自動化機能を使用することで、WhatsApp UIを直接操作することなく、メッセージの送信やWhatsAppのステータス確認のためのシンプルなインターフェースを提供します。
特徴
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 の利用規約に従って使用してください。
You must be authenticated.
macOS 上の WhatsApp デスクトップとのプログラムによる対話を可能にする Node.js アプリケーション。ユーザーは、直接 UI を操作せずに、AppleScript の自動化を通じてメッセージを送信したり、WhatsApp のステータスを確認したりできます。