MCP Whatsapp Server

🚀 MCP プロトコルベースの WhatsApp サーバー

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、API Waha を通じて WhatsApp との統合を実現します。

🚀 クイックスタート

このサーバーを使用することで、MCP 互換の AI アシスタント（Claude など）が直接 WhatsApp 上の連絡先とやり取りできるようになります。サーバーは Waha API をバックエンドとして使用し、WhatsApp Web との通信を実現します。

✨ 主な機能

• ✅ WhatsApp 接続状態の検証
• ✅ 電話番号を通じたメッセージ送信
• ✅ 登録済みの連絡先名を通じたメッセージ送信
• ✅ 連絡先の管理（名前で）
• ✅ サーバー設定の確認

📦 インストール

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 (オプション)
   

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

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

💻 使用例

基本的な使用法

1. 公式の説明に従って Waha API を起動します。
2. MCP サーバーを実行します。

   python server.py
   

3. 互換性のある MCP クライアント（Claude Desktop など）を使用してサーバーとやり取りします。

高度な使用法

接続状態の検証

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']}")

📚 ドキュメント

利用可能な MCP リソース

リソース

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

ツール

• verificar_conexao_whatsapp() - 現在の WhatsApp 接続状態を検証します。
• enviar_mensagem_whatsapp(numero, mensagem) - 電話番号を通じてメッセージを送信します。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。