ADB MCP Server

Servidor MCP de ADB

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar con dispositivos Android mediante ADB. Esta herramienta basada en TypeScript conecta los modelos de IA con la funcionalidad de los dispositivos Android.

Características

• 📱 Administración de dispositivos: enumera e interactúa con los dispositivos Android conectados
• 📦 Instalación de la aplicación: Implementar archivos APK en dispositivos conectados
• 📋 Registro: acceda a los registros del dispositivo a través de logcat
• 🔄 Transferencia de archivos: envíe y reciba archivos entre el dispositivo y el host
• 📸 Interacción de la interfaz de usuario: captura capturas de pantalla y analiza la jerarquía de la interfaz de usuario
• 🔧 Ejecución de comandos de Shell: ejecuta comandos personalizados en el dispositivo

Prerrequisitos

• Node.js (se recomienda v16 o superior, probado con Node.js v16, v18 y v20)
• ADB (Android Debug Bridge) instalado y en su PATH
• Un dispositivo o emulador de Android conectado a través de USB o red con la depuración USB habilitada
• Permiso para acceder al dispositivo (autorización de depuración aceptada en el dispositivo)

Instalación

Instalación mediante herrería

Para instalar ADB Android Device Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Configuración

Configuración de ruta ADB

El servidor utiliza las rutas ADB predeterminadas. Para una ubicación ADB personalizada:

Configuración de MCP

Agregue la configuración del servidor ADB MCP:

Uso

Iniciando el servidor

IMPORTANTE: El servidor debe estar ejecutándose antes de utilizar cualquier herramienta ADB.

Inicie el servidor usando:

Deberías ver:

Mantenga esta ventana de terminal abierta mientras utiliza las herramientas ADB.

Herramientas disponibles

Todas las herramientas están disponibles con la siguiente convención de nomenclatura:

📱 Administración de dispositivos

• adb_devices - Lista de dispositivos conectados
• adb_shell - Ejecutar comandos de shell en un dispositivo

📦 Gestión de aplicaciones

• adb_install - Instala un archivo APK usando una ruta de archivo local

📋 Registro

• adb_logcat - Ver registros del dispositivo con filtrado opcional

🔄 Transferencia de archivos

• adb_pull - Extraer archivos de un dispositivo
• adb_push - Enviar archivos a un dispositivo

🔍Interacción de la interfaz de usuario

• dump_image - Toma una captura de pantalla de la pantalla actual
• inspect_ui : obtiene la jerarquía de la interfaz de usuario en formato XML (muy útil para la interacción con IA)

Solución de problemas

Si las herramientas no funcionan:

• Problemas con el servidor:
  • Asegúrese de que el servidor esté en ejecución ( npx adb-mcp )
  • Comprobar la salida del servidor en busca de mensajes de error
  • Pruebe los registros detallados: LOG_LEVEL=3 npx adb-mcp
  • Procesos de matar colgados:
    • ps aux | grep "adb-mcp" | grep -v grep
    • entonces kill -9 [PID]
• Conexión del dispositivo:
  • Verificar la conexión con adb_devices
  • Si no está autorizado, acepte la autorización de depuración en el dispositivo
  • Comprobar las conexiones USB/de red
  • Intente reiniciar ADB: adb kill-server && adb start-server
• Problemas del BAD:
  • Verificar la instalación de ADB: adb version
• Configuración del dispositivo:
  • Utilice un emulador (se creó utilizando uno), para dispositivos reales tal vez pruebe esto:
    • Asegúrese de que la depuración USB esté habilitada
    • Para versiones más nuevas de Android, habilite "Depuración USB (Configuración de seguridad)".
    • Pruebe con un puerto USB o cable diferente
    • o déjame saber en un problema

Compatibilidad

• Android 8.0 y superior
• Clientes MCP que incluyen a Claude en Cursor IDE
• Fue creado en macOS pero debería ejecutarse en cualquier sistema compatible con POSIX (Linux, etc.).
• No lo probé en Windows pero tal vez funcione.

Contribuyendo

• ¡Agradecemos sus contribuciones! Envíe una solicitud de extracción.
• Para cambios importantes, abra primero un problema para discutirlo.
• Por supuesto, también puedes bifurcarlo.
• Nota: este proyecto fue vibe-coded así que si ves algo raro... bueno, ahora lo sabes 🙂

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

• Construido con el Protocolo de Contexto de Modelo (MCP)