Evolution API MCP

Evolution API (オープンソース、セルフホスト) を使用して、Claude Codeから直接WhatsAppメッセージを送受信するためのMCPサーバーです。

機能

• WhatsAppインスタンスの作成と管理

• テキスト、メディア、音声、位置情報、連絡先、アンケート、ステッカー、ボタン、リストの送信

• 受信した会話やメッセージの読み取り

• メッセージへのリアクション、チャットのアーカイブ、既読設定

Related MCP server: mcp-evolution

前提条件

• Docker Desktop

• Python 3.11+

• uv (Pythonパッケージマネージャー)

• Claude Code

インストール

1. Evolution APIの起動

git clone https://github.com/SEU_USUARIO/evolution-api-mcp.git
cd evolution-api-mcp
docker compose up -d

15秒ほど待ってからテストします：

curl http://localhost:8080/

{"status":200,"message":"Welcome to the Evolution API, it is working!"} が返されるはずです。

2. MCPサーバーのインストール

uv venv
uv pip install -e .

3. Claude Codeへの登録

claude mcp add evolution-api -s user -- evolution-api-mcp

または、~/.claude.json ファイルに手動で追加します：

{
  "mcpServers": {
    "evolution-api": {
      "type": "stdio",
      "command": "evolution-api-mcp",
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "evo_mcp_2024"
      }
    }
  }
}

Windows: コマンドには .exe へのフルパスが必要な場合があります： C:/Users/YOUR_USER/evolution-api-mcp/.venv/Scripts/evolution-api-mcp.exe

4. WhatsAppの接続

1. ブラウザで http://localhost:8080/manager/ を開きます

2. グローバルAPIキー evo_mcp_2024 を使用します

3. インスタンスを作成します（例: "meuwhats"）

4. 「QRコードを生成」をクリックします

5. WhatsAppでスキャンします：設定 > リンクされたデバイス > デバイスをリンク

5. 使用方法

Claude Codeを再起動して使用を開始します：

> envia uma mensagem pro 5511999999999 dizendo oi
> mostra minhas conversas recentes
> envia uma foto pra fulano

設定

Docker ComposeのデフォルトAPIキーは evo_mcp_2024 です。必要に応じて docker-compose.yml で変更してください。

構造

evolution-api-mcp/
├── docker-compose.yml          # Evolution API + PostgreSQL
├── pyproject.toml               # Dependencias Python
└── src/evolution_api_mcp/
    ├── server.py                # MCP server (FastMCP + CodeMode)
    ├── client.py                # HTTP client async
    └── tools/
        ├── instance.py          # Criar/conectar/deletar instancias
        ├── messages.py          # Enviar texto, midia, audio, etc.
        └── chat.py              # Listar chats, ler mensagens

利用可能なツール

インスタンス

• create_instance - WhatsAppインスタンスの作成

• connect_instance - 接続してQRコードを生成

• fetch_instances - インスタンスの一覧表示

• connection_state - 接続状態の確認

• logout_instance - WhatsAppのログアウト

• restart_instance - インスタンスの再起動

• delete_instance - インスタンスの削除

メッセージ

• send_text - テキストの送信

• send_media - 画像、動画、ドキュメントの送信

• send_audio - 音声/ボイスメモの送信

• send_location - 位置情報の送信

• send_contact - 連絡先カードの送信

• send_reaction - 絵文字でのリアクション

• send_poll - アンケートの送信

• send_buttons - インタラクティブボタンの送信

• send_list - インタラクティブリストの送信

• send_sticker - ステッカーの送信

チャット

• find_chats - 会話の一覧表示

• find_messages - チャット内のメッセージ読み取り

• archive_chat - チャットのアーカイブ/アーカイブ解除

• mark_message_as_read - 既読にする

ライセンス

MIT