MCP WhatsApp Server

MCP WhatsApp サーバー

Model Context Protocol (MCP) に基づくサーバーで、Waha API を通じて WhatsApp と連携します。

プロジェクトについて

このサーバーを使用すると、MCP 対応の AI アシスタント（Claude など）が WhatsApp の連絡先と直接やり取りできます。このプロジェクトでは、WhatsApp Web との通信バックエンドとして Waha API を使用しています。

機能

• ✅ WhatsApp の接続状態の確認
• ✅ 電話番号を指定したメッセージの送信
• ✅ 登録済みの連絡先名を指定したメッセージの送信
• ✅ 名前による連絡先の管理
• ✅ サーバー設定の表示

要件

• Python 3.7+
• 実行中の Waha API
• MCP ライブラリ（Fast MCP）

インストール

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

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

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

   pip install -r requirements.txt
   

3. .env ファイルで環境変数を設定します：

   WAHA_API_URL=http://localhost:3000
   WAHA_SESSION_ID=default
   CONTATOS_FILE=caminho/para/contatos.json (opcional)
   

4. contatos.json ファイルで連絡先を設定します：

   {
       "contatos": {
           "Nome1": "5511999999999",
           "Nome2": "5522888888888"
       }
   }
   

使用方法

1. 公式の手順に従って Waha API を起動します

2. MCP サーバーを実行します：

   python server.py
   

3. MCP 対応クライアント（Claude Desktop など）でサーバーを使用します

利用可能な MCP リソース

リソース

• waha://configuracao - Waha API の設定
• waha://status - WhatsApp の現在の接続状態
• waha://contatos - 名前でマッピングされた連絡先の一覧

ツール

• verificar_conexao_whatsapp() - 現在の接続状態を確認します
• enviar_mensagem_whatsapp(numero, mensagem) - 電話番号を指定してメッセージを送信します

使用例

接続状態の確認

status = verificar_conexao_whatsapp()
print(f"Status: {status['mensagem']}")

電話番号を指定したメッセージの送信

resultado = enviar_mensagem_whatsapp("5511999999999", "Olá! Esta é uma mensagem de teste.")
print(f"Resultado: {resultado['mensagem']}")

名前を指定したメッセージの送信

resultado = enviar_mensagem_por_nome("Pedro", "Olá! Esta é uma mensagem de teste.")
print(f"Resultado: {resultado['mensagem']}")

コントリビューション

コントリビューションを歓迎します！お気軽に issue を作成するか、プルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。

画像とデモ

使用例