Whatsapp Desktop

🚀 WhatsApp MCP サーバー

WhatsApp MCP（モデルコンテキストプロトコル）サーバーは、Node.js ベースのアプリケーションです。これにより、AppleScript を使って macOS 上にインストールされた WhatsApp デスクトップアプリケーションとプログラム的にやり取りできます。WhatsApp のユーザーインターフェイスを直接操作することなく、メッセージの送信や WhatsApp の状態を確認できます。

✨ 主な機能

1. 連絡先へのメッセージ送信

WhatsApp の連絡先リスト内の特定の連絡先にテキストメッセージを送信できます。

• メッセージは接続された WhatsApp デスクトップアプリケーションを通じて送信されます。
• 改行文字を含むメッセージの書式設定に対応しています。
• AppleScript を使って WhatsApp デスクトップインターフェイスを自動化します。

2. WhatsApp の状態確認（開発中）

WhatsApp アプリケーションが現在実行中かどうかを検証します。

• WhatsApp の現在の実行状態を返します。
• メッセージ送信時のエラーを防ぎます。

3. 最近の連絡先の一覧表示（開発中）

WhatsApp のプライバシー保護制限のため、この機能の利用は制限されています。

• ユーザーに WhatsApp のプライバシー制限について通知します。
• メッセージ送信のためにユーザーに正確な連絡先名を提供するよう要求します。

🔧 技術詳細

使用ツール

• @modelcontextprotocol/sdk - MCP サーバーと stdio トランスポート
• Zod - スキーマ検証
• Node.js の組み込みモジュール（child_process、util、fs）
• AppleScript を使った macOS の自動化

アーキテクチャ

• モデルコンテキストプロトコル（MCP）を使ってツール間の標準化された通信を実現します。
• stdio トランスポートを使って通信します。
• AppleScript コマンドを実行して WhatsApp デスクトップアプリケーションとやり取りします。
• 完全なエラーログ記録を実装しています。

📦 インストール

必要条件

• Windows、macOS または Linux システム
• Node.js 14.17.0 以上
• npm 6.0.0 以上
• WhatsApp デスクトップアプリケーションがインストールされ、ログイン済み

手順

1. ソースコードパッケージをダウンロードします。
2. ファイルパッケージを解凍します。
3. ターミナルを開き、解凍したディレクトリに移動します。
4. コマンドを実行します：npm install
5. インストールが成功したら、ターミナルで npm start を実行してサービスを開始します。

💻 使用例

メッセージの送信

curl -X POST http://localhost:3000/api/send-message \
     -H "Content-Type: application/json" \
     -d '{"to": "+1234567890", "message": "こんにちは！"}'

状態の確認

curl http://localhost:3000/api/status

使用方法

• プロジェクトのルートディレクトリにある docs フォルダ内の API ドキュメントを参照してください。
• 設定ファイルを使ってサーバーのパラメータをカスタマイズできます。
• RESTful API または CLI を使って機能を呼び出せます。

📚 統合ガイド

1. WhatsApp MCP サーバーをインストールして実行します。
2. Claude Desktop の MCP ツール設定を構成します。
3. app-settings.json に以下の内容を追加します。

   "mcp.tools.whatsapp": {
     "host": "localhost",
     "port": 3000,
     "timeout": 5000
   }
   

4. Claude Desktop で MCP ツールプラグインを有効にします。

📄 ライセンス

MIT

⚠️ 重要提示

このプロジェクトは WhatsApp Inc. または Meta Platforms, Inc. からの公式サポートを受けていません。使用する前に WhatsApp のサービス利用規約をよく読み、自己責任で使用してください。

💡 使用建议

このサーバーはあなたの個人の WhatsApp アカウントとやり取りします。メッセージはあなたのアカウントから送信され、あなたが送信したものとして表示されます。信頼できる環境でのみ使用してください。