MCP Vysor

Servidor Model Context Protocol (MCP) para controle visual de dispositivos Android via ADB. Permite que agentes de IA no Cursor, Claude Desktop e outros clientes MCP vejam a tela do celular, cliquem em coordenadas, inspecionem elementos da UI e automatizem fluxos — similar ao Vysor, mas integrado nativamente ao seu IDE.

Por que usar?

• Visualização real: screenshots retornados como imagem para o agente analisar
• Cliques precisos: tap por pixels, porcentagem ou elemento semântico
• Grade de coordenadas: identifique posições x,y diretamente na imagem
• 18 ferramentas: cobre screenshot, gestos, UI dump, shell, apps e teclas
• Zero config extra: usa o adb que você já tem instalado

Demonstração de fluxo

1. adb_screenshot_with_grid  →  agente vê a tela com coordenadas
2. adb_tap x=996 y=2073      →  clica na aba "Perfil"
3. adb_find_elements         →  encontra "Desativar notificações push"
4. adb_tap_element           →  desativa o toggle
5. adb_screenshot            →  confirma visualmente

Requisitos

• Node.js 18+
• Android Platform Tools (ADB)
• Dispositivo Android 8.0+ com depuração USB ativada

Instalação rápida

Opção A — npx (recomendado)

npx -y mcp-vysor

Opção B — clone e build

git clone https://github.com/glira/mcp-vysor.git
cd mcp-vysor
npm install
npm run build

Guia completo: docs/INSTALLATION.md

Configuração no Cursor

Adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vysor": {
      "command": "npx",
      "args": ["-y", "mcp-vysor"],
      "env": {
        "ADB_PATH": "adb"
      }
    }
  }
}

Alternativa com clone local:

{
  "mcpServers": {
    "vysor": {
      "command": "node",
      "args": ["/caminho/absoluto/mcp-vysor/dist/index.js"],
      "env": { "ADB_PATH": "adb" }
    }
  }
}

Guia detalhado: docs/CURSOR.md

Ferramentas disponíveis

| Categoria | Ferramentas | |-----------|-------------| | Tela | adb_list_devices, adb_get_screen_info, adb_screenshot, adb_screenshot_with_grid, adb_get_current_app | | Coordenadas | adb_tap, adb_tap_percent, adb_tap_from_image_coords, adb_swipe, adb_long_press, adb_get_coordinates | | UI | adb_ui_dump, adb_find_elements, adb_tap_element | | Entrada | adb_input_text, adb_keyevent, adb_shell, adb_start_app, adb_stop_app |

Referência completa com parâmetros: docs/TOOLS.md

Variáveis de ambiente

| Variável | Descrição | Padrão | |----------|-----------|--------| | ADB_PATH | Caminho do executável adb | adb | | ADB_DEVICE | Serial padrão do dispositivo | auto (se 1 device) |

Documentação

| Documento | Conteúdo | |-----------|----------| | Instalação | Pré-requisitos, ADB, build, verificação | | Cursor | Configuração MCP no IDE | | Ferramentas | Referência completa de cada tool | | Arquitetura | Design, módulos, fluxos, limitações | | Troubleshooting | Problemas comuns e soluções | | Publicação | Registro oficial MCP e diretórios | | Contribuindo | Como contribuir | | Changelog | Histórico de versões |

mcp-name: io.github.glira/mcp-vysor

Desenvolvimento

npm run dev    # servidor MCP em modo desenvolvimento
npm run build  # compila TypeScript → dist/

Licença

MIT — Copyright (c) 2026 Gemayel Lira

Autor

Gemayel Lira — github.com/glira