Whatsapp MCP Plus

WhatsApp MCP Plus

Fork melhorado do whatsapp-mcp com correcoes criticas e otimizacoes de performance.

O que ha de diferente?

Pre-requisitos

• Go 1.21+
• Python 3.11+
• uv (gerenciador Python)
• FFmpeg (opcional, para mensagens de audio)

Instalacao

1. Clone o repositorio

git clone https://github.com/SEU_USUARIO/whatsapp-mcp-plus.git
cd whatsapp-mcp-plus

2. Compile o bridge

cd whatsapp-bridge
go build -o whatsapp-bridge main.go

3. Primeira execucao (autenticacao)

./whatsapp-bridge

Um QR code vai aparecer no terminal. Escaneie com: WhatsApp > Configuracoes > Aparelhos conectados > Conectar aparelho

Apos autenticar, a sessao fica salva. Nas proximas vezes, conecta automaticamente.

4. Execucoes seguintes (com script)

cd ..
chmod +x start-bridge.sh
./start-bridge.sh

O script:

• Mata instancias anteriores
• Libera a porta 8080
• Gera QR code como PNG em /tmp/wa_qrcode.png (se necessario)
• Envia notificacoes macOS

5. Configure seu cliente MCP

Descubra o caminho do uv:

which uv

Claude Code (CLI)

Adicione em ~/.claude/.mcp.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "/CAMINHO/PARA/uv",
      "args": [
        "--directory",
        "/CAMINHO/PARA/whatsapp-mcp-plus/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "/CAMINHO/PARA/uv",
      "args": [
        "--directory",
        "/CAMINHO/PARA/whatsapp-mcp-plus/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Cursor

Adicione em ~/.cursor/mcp.json (mesmo formato acima).

6. Reinicie o cliente

Reinicie o Claude Desktop, Cursor, ou a sessao do Claude Code.

Tools disponiveis

Arquitetura

WhatsApp Cloud  Go Bridge (whatsmeow)  SQLite  Python MCP Server  Claude
                        |
                   REST API :8080
                  /api/send
                  /api/download
                  /api/status

1. O Go Bridge conecta ao WhatsApp via whatsmeow e armazena tudo em SQLite
2. O Python MCP Server le do SQLite e expoe tools via protocolo MCP
3. Para enviar mensagens, o MCP Server chama a REST API do Bridge

Troubleshooting

Mensagens nao aparecem para um contato

O WhatsApp migrou para LIDs (Linked Device IDs). Este fork resolve automaticamente. Busque pelo nome do contato, nao pelo numero.

Bridge desconecta

O MCP Plus tem reconexao automatica com backoff exponencial. Se persistir, delete os arquivos em whatsapp-bridge/store/ e re-autentique.

QR code nao aparece no terminal

Use start-bridge.sh que gera um PNG em /tmp/wa_qrcode.png.

Erro ao compilar no Windows

O go-sqlite3 requer CGO habilitado:

cd whatsapp-bridge
go env -w CGO_ENABLED=1
go build -o whatsapp-bridge.exe main.go

Voce precisa de um compilador C instalado (ex: MSYS2).

Health check

Verifique se o bridge esta rodando:

curl http://localhost:8080/api/status

Retorna: {"connected": true, "logged_in": true, "timestamp": "..."}

Licenca

MIT License. Veja LICENSE.