ADB MCP Server

Interactúa con dispositivos Android usando el Android Debug Bridge (ADB).

GitHub
16

Documentación

Servidor ADB MCP

Este es un servidor MCP para Android Debug Bridge (ADB), que permite a Claude interactuar con dispositivos Android.

Artículo técnico

Lista de herramientas

  1. get-devices

    • Lista los dispositivos Android conectados
    • Parámetros opcionales:
      • showDetails (booleano, por defecto: true): muestra información detallada del dispositivo (-l)

  2. list-packages

    • Lista los paquetes instalados en el dispositivo
    • Parámetros opcionales:
      • showPath (booleano, por defecto: false): muestra la ruta del archivo APK (-f)
      • showDisabled (booleano, por defecto: false): muestra solo los paquetes deshabilitados (-d)
      • showEnabled (booleano, por defecto: false): muestra solo los paquetes habilitados (-e)
      • showSystem (booleano, por defecto: false): muestra solo los paquetes del sistema (-s)
      • showThirdParty (booleano, por defecto: false): muestra solo los paquetes de terceros (-3)
      • showInstaller (booleano, por defecto: false): muestra el instalador del paquete (-i)
      • includeUninstalled (booleano, por defecto: false): incluye paquetes desinstalados (-u)

  3. input-text

    • Envía texto al dispositivo
    • Parámetros requeridos:
      • text (cadena): el texto a enviar

  4. install-apk

    • Instala un archivo APK en el dispositivo
    • Parámetros requeridos:
      • apkPath (cadena): ruta del archivo APK
    • Parámetros opcionales:
      • allowReinstall (booleano, por defecto: true): permite reinstalar (-r)
      • allowTestPackages (booleano, por defecto: true): permite paquetes de prueba (-t)
      • allowDowngrade (booleano, por defecto: true): permite degradar (-d)
      • grantPermissions (booleano, por defecto: false): otorga todos los permisos (-g)

  5. uninstall-apk

    • Desinstala una aplicación
    • Parámetros requeridos:
      • packageName (cadena): nombre del paquete a desinstalar
    • Parámetros opcionales:
      • keepData (booleano, por defecto: false): conserva los datos y la caché de la aplicación (-k)

  6. clear-app-data

    • Borra los datos de la aplicación
    • Parámetros requeridos:
      • packageName (cadena): nombre del paquete cuyos datos se van a borrar

  7. pull

    • Extrae un archivo del dispositivo
    • Parámetros requeridos:
      • remotePath (cadena): ruta del archivo en el dispositivo
    • Parámetros opcionales:
      • localPath (cadena): ruta de destino local

  8. push

    • Envía un archivo al dispositivo
    • Parámetros requeridos:
      • localPath (cadena): ruta del archivo local
      • remotePath (cadena): ruta de destino en el dispositivo

  9. screencap

    • Toma una captura de pantalla
    • Parámetros requeridos:
      • remotePath (cadena): ruta para guardar la captura en el dispositivo (por ejemplo: /sdcard/screenshot.png)
    • Parámetros opcionales:
      • usePng (booleano, por defecto: true): guardar en formato PNG (-p)

  10. rm

    • Elimina un archivo del dispositivo Android
    • Parámetros requeridos:
      • path (cadena): ruta del archivo en el dispositivo a eliminar
    • Parámetros opcionales:
      • force (booleano, por defecto: false): forzar eliminación (-f)
      • recursive (booleano, por defecto: false): eliminación recursiva (-r)

  11. reset-permissions

    • Restablece todos los permisos de la aplicación
    • Parámetros requeridos:
      • packageName (cadena): nombre del paquete de destino

  12. grant-permission

    • Otorga un permiso específico
    • Parámetros requeridos:
      • packageName (cadena): nombre del paquete de destino
      • permission (cadena): el permiso a otorgar

Instrucciones de configuración

  1. Instalar ADB:

    • Descargar Android SDK Platform Tools
    • Agregar ADB a las variables de entorno del sistema
    • Verificar la instalación usando adb version

  2. Habilitar la depuración por USB:

    • En el dispositivo Android, ve a Configuración > Acerca del teléfono
    • Toca el número de versión 7 veces para habilitar las opciones de desarrollador
    • Habilita la depuración por USB en las opciones de desarrollador

Instalar el servidor

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

# 安装依赖
npm install

# 构建项目
npm run build

Uso en Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

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

Reemplaza /path/to/adb con la ruta real de tu ejecutable de ADB.

Uso en Windsurf

  1. Primero asegúrate de tener Node.js y ADB instalados.

  2. Clona y compila el proyecto:

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

    O usa directamente el proyecto ya clonado:

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

  3. Agrega la configuración de MCP en la configuración de Windsurf:

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

    Nota:

    • Reemplaza las rutas con tus rutas reales
    • /usr/local/bin/adb es la ruta de instalación predeterminada de ADB; si tu ADB está instalado en otra ubicación, modifícalo en consecuencia
    • Asegúrate de que todas las rutas usen rutas absolutas

  4. Reinicia Windsurf para que la configuración surta efecto

Licencia

Este proyecto está bajo la licencia MIT - consulta el archivo LICENSE para más detalles.