ADB MCP Server

Interaja com dispositivos Android usando o Android Debug Bridge (ADB).

GitHub
15
Experimente este MCPPatrocinado

Documentação

Servidor MCP ADB

Este é um servidor MCP para Android Debug Bridge (ADB), permitindo que o Claude interaja com dispositivos Android.

Artigo Técnico

Lista de Ferramentas

  1. get-devices

    • Lista dispositivos Android conectados
    • Parâmetros opcionais:
      • showDetails (booleano, padrão: true): exibe detalhes do dispositivo (-l)

  2. list-packages

    • Lista pacotes instalados no dispositivo
    • Parâmetros opcionais:
      • showPath (booleano, padrão: false): exibe caminhos dos arquivos APK (-f)
      • showDisabled (booleano, padrão: false): exibe apenas pacotes desabilitados (-d)
      • showEnabled (booleano, padrão: false): exibe apenas pacotes habilitados (-e)
      • showSystem (booleano, padrão: false): exibe apenas pacotes do sistema (-s)
      • showThirdParty (booleano, padrão: false): exibe apenas pacotes de terceiros (-3)
      • showInstaller (booleano, padrão: false): exibe instaladores de pacotes (-i)
      • includeUninstalled (booleano, padrão: false): inclui pacotes desinstalados (-u)

  3. input-text

    • Insere texto no dispositivo
    • Parâmetros obrigatórios:
      • text (string): texto a ser inserido

  4. install-apk

    • Instala um arquivo APK no dispositivo
    • Parâmetros obrigatórios:
      • apkPath (string): caminho do arquivo APK
    • Parâmetros opcionais:
      • allowReinstall (booleano, padrão: true): permite reinstalação (-r)
      • allowTestPackages (booleano, padrão: true): permite pacotes de teste (-t)
      • allowDowngrade (booleano, padrão: true): permite downgrade (-d)
      • grantPermissions (booleano, padrão: false): concede todas as permissões (-g)

  5. uninstall-apk

    • Desinstala um aplicativo
    • Parâmetros obrigatórios:
      • packageName (string): nome do pacote a ser desinstalado
    • Parâmetros opcionais:
      • keepData (booleano, padrão: false): mantém dados e cache do aplicativo (-k)

  6. clear-app-data

    • Limpa dados do aplicativo
    • Parâmetros obrigatórios:
      • packageName (string): nome do pacote cujos dados serão limpos

  7. pull

    • Puxa arquivos do dispositivo
    • Parâmetros obrigatórios:
      • remotePath (string): caminho do arquivo no dispositivo
    • Parâmetros opcionais:
      • localPath (string): caminho de destino local

  8. push

    • Envia arquivos para o dispositivo
    • Parâmetros obrigatórios:
      • localPath (string): caminho do arquivo local
      • remotePath (string): caminho de destino no dispositivo

  9. screencap

    • Captura uma captura de tela
    • Parâmetros obrigatórios:
      • remotePath (string): caminho para salvar a captura no dispositivo (ex.: /sdcard/screenshot.png)
    • Parâmetros opcionais:
      • usePng (booleano, padrão: true): salva no formato PNG (-p)

  10. rm

    • Exclui arquivos do dispositivo Android
    • Parâmetros obrigatórios:
      • path (string): caminho do arquivo no dispositivo a ser excluído
    • Parâmetros opcionais:
      • force (booleano, padrão: false): exclusão forçada (-f)
      • recursive (booleano, padrão: false): exclusão recursiva (-r)

  11. reset-permissions

    • Redefine todas as permissões de um aplicativo
    • Parâmetros obrigatórios:
      • packageName (string): nome do pacote de destino

  12. grant-permission

    • Concede uma permissão específica
    • Parâmetros obrigatórios:
      • packageName (string): nome do pacote de destino
      • permission (string): permissão a ser concedida

Instruções de Configuração

  1. Instale o ADB:

    • Baixe o Android SDK Platform Tools
    • Adicione o ADB às variáveis de ambiente do sistema
    • Use adb version para verificar a instalação

  2. Habilite a depuração USB:

    • No dispositivo Android, vá para Configurações > Sobre o telefone
    • Toque no número da versão 7 vezes para habilitar as opções do desenvolvedor
    • Habilite a depuração USB nas opções do desenvolvedor

Instalação do Servidor

# 克隆仓库
git clone [repository-url]
cd mcp-server-adb

# 安装依赖
npm install

# 构建项目
npm run build

Uso no Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": ["-y", "/path/to/mcp-server-adb/build/index.js", "/path/to/adb"]
    }
  }
}

Substitua /path/to/adb pelo caminho real do seu executável ADB.

Uso no Windsurf

  1. Primeiro, certifique-se de que o Node.js e o ADB estejam instalados

  2. Clone e construa o projeto:

    git clone https://github.com/jiantao88/android-mcp-server.git
cd android-mcp-server
npm install
npm run build

    Ou use diretamente um projeto já clonado:

    cd /path/to/android-mcp-server
npm install
npm run build

  3. Adicione a configuração do MCP nas configurações do Windsurf:

    {
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": [
        "/path/to/android-mcp-server/build/index.js",
        "/usr/local/bin/adb"
      ]
    }
  }
}

    Observação:

    • Substitua os caminhos pelos seus caminhos reais
    • /usr/local/bin/adb é o caminho de instalação padrão do ADB; se o seu ADB estiver instalado em outro local, modifique de acordo
    • Certifique-se de que todos os caminhos usem caminhos absolutos

  4. Reinicie o Windsurf para que a configuração entre em vigor

Licença

Este projeto é licenciado sob a licença MIT - consulte o arquivo LICENSE para mais detalhes.