Whatsapp MCP Server I37

🚀 WhatsApp 多通道プラットフォームサーバー

このサーバーは、WhatsApp を統合するための多チャネルプラットフォームで、REST API を通じてメッセージの送受信を実現します。

✨ 主な機能

• WhatsApp 接続管理と QR コード認証
• テキストメッセージの送受信
• メディアメッセージ（画像、ドキュメントなど）の送信
• 連絡先管理
• チャット履歴
• セッションの永続化
• 他のアプリケーションと統合するための REST API

📦 インストール

前提条件

• Node.js (v14 以上)
• MongoDB（メッセージの保存にはオプションですが、推奨）
• WhatsApp アカウント

手順

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

git clone https://github.com/krusleung/whatsapp-mcp-server.git
cd whatsapp-mcp-server

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

npm install

3. サンプルから .env ファイルを作成します：

cp .env.example .env

4. 設定を使用して .env ファイルを編集します。

🚀 クイックスタート

開発サーバーの起動

npm run dev

本番環境

npm start

📚 ドキュメント

API ドキュメント

認証

サーバーは WhatsApp Web の QR コードを使用して認証します。サーバーを初めて起動すると、コンソールに QR コードが表示されます。あなたの WhatsApp モバイルアプリを使用してスキャンします：

1. 携帯電話で WhatsApp を開きます。
2. メニューまたは設定をクリックし、WhatsApp Web を選択します。
3. コンソールに表示される QR コードをスキャンします。

API エンドポイント

認証ルート

• GET /api/auth/status - 認証ステータスを確認します。
• POST /api/auth/logout - WhatsApp からログアウトします。
• POST /api/auth/restart - WhatsApp クライアントを再起動します。

メッセージルート

• POST /api/messages/send - テキストメッセージを送信します。
• POST /api/messages/send-media - メディアメッセージを送信します。
• GET /api/messages/history/:contact - 連絡先とのチャット履歴を取得します。

連絡先ルート

• GET /api/contacts - すべての連絡先を取得します。
• GET /api/contacts/:id - ID で連絡先を取得します。
• GET /api/contacts/chats - すべての会話を取得します。

💻 使用例

メッセージの送信

curl -X POST http://localhost:3000/api/messages/send \
  -H "Content-Type: application/json" \
  -d '{"to": "1234567890", "message": "Hello from WhatsApp MCP Server!"}'

連絡先の取得

curl -X GET http://localhost:3000/api/contacts

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。

謝辞

• whatsapp-web.js - WhatsApp Web API
• Express - ウェブフレームワーク
• Mongoose - MongoDB ODM