ARCHIVADO -- Utilice mobile-device-mcp

Bastante sorprendido de que este repositorio haya alcanzado las 50 estrellas (!) el ecosistema es bastante generoso a veces, ¡gracias por marcarlo como favorito!

He estado trabajando en algo que es más rápido, más escalable y que también funciona con iOS, eche un vistazo a mobile-device-mcp.

Y deje también una ⭐ :)

Servidor MCP de ADB

Un servidor MCP (Model Context Protocol) para interactuar con dispositivos Android a través de ADB. Esta herramienta basada en TypeScript proporciona un puente entre los modelos de IA y la funcionalidad de los dispositivos Android.

Related MCP server: Android Mobile MCP

Características

• 📱 Gestión de dispositivos - Listar e interactuar con dispositivos Android conectados

• 📦 Instalación de aplicaciones - Desplegar archivos APK en dispositivos conectados

• 📋 Registro (Logging) - Acceder a los registros del dispositivo a través de logcat

• 🔄 Transferencia de archivos - Enviar y recibir archivos entre el dispositivo y el host

• 📸 Interacción con la interfaz de usuario - Capturar capturas de pantalla y analizar la jerarquía de la interfaz de usuario

• 🔧 Ejecución de comandos de shell - Ejecutar comandos personalizados en el dispositivo

Requisitos previos

• 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 Android o emulador conectado mediante 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 a través de Smithery

Para instalar el servidor de dispositivos Android ADB para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @srmorete/adb-mcp --client claude

Instalación manual

# Clone the repository
git clone https://github.com/srmorete/adb-mcp.git
cd adb-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Run the server
npx adb-mcp

Configuración

Configuración de la ruta de ADB

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

export ADB_PATH=/path/to/adb
npx adb-mcp

Configuración de MCP

Añada la configuración del servidor MCP de ADB:

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ]
    }
  }
}

Uso

Iniciar el servidor

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

Inicie el servidor usando:

npx adb-mcp

Debería ver:

[INFO] ADB MCP Server connected and ready

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 nombres:

📱 Gestión de dispositivos

• adb_devices - Listar dispositivos conectados

• adb_shell - Ejecutar comandos de shell en un dispositivo

📦 Gestión de aplicaciones

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

• adb_package_manager - Ejecutar comandos del Administrador de paquetes (pm) - listar paquetes, conceder/revocar permisos, gestionar aplicaciones

• adb_activity_manager - Ejecutar comandos del Administrador de actividades (am) - iniciar actividades, transmitir intents, controlar el comportamiento de la aplicación

📋 Registro (Logging)

• adb_logcat - Ver los 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 con la interfaz de usuario

• dump_image - Tomar una captura de pantalla de la pantalla actual

• inspect_ui - Obtener la jerarquía de la interfaz de usuario en formato XML (más útil para la interacción con IA)

Solución de problemas

Si las herramientas no funcionan:

• Problemas del servidor:

  • Asegúrese de que el servidor se esté ejecutando (npx adb-mcp)

  • Compruebe la salida del servidor en busca de mensajes de error

  • Pruebe con registros detallados: LOG_LEVEL=3 npx adb-mcp

  • Elimine los procesos colgados:

    • ps aux | grep "adb-mcp" | grep -v grep

    • luego kill -9 [PID]

• Conexión del dispositivo:

  • Verifique la conexión con adb_devices

  • Si aparece "unauthorized", acepte la autorización de depuración en el dispositivo

  • Compruebe las conexiones USB/red

  • Intente reiniciar ADB: adb kill-server && adb start-server

• Problemas de ADB:

  • Verifique la instalación de ADB: adb version

• Configuración del dispositivo:

  • Use un emulador (fue construido usando uno), para dispositivos reales quizás intente esto:

    • Asegúrese de que la depuración USB esté habilitada

    • Para versiones más nuevas de Android, habilite "Depuración USB (ajustes de seguridad)"

    • Pruebe con un puerto USB o cable diferente

    • o hágamelo saber en un issue

Compatibilidad

• Android 8.0 y superior

• Clientes MCP incluyendo Claude en Cursor IDE

• Fue construido en macOS pero debería ejecutarse en cualquier sistema compatible con POSIX (Linux, etc.).

• No lo probé en Windows pero quizás funcione.

Contribución

• ¡Las contribuciones son bienvenidas! Envíe un Pull Request.

• Para cambios importantes, abra un issue para discutirlo primero.

• Por supuesto, también puede hacer un fork

• Nota: este proyecto fue vibe-coded así que si detecta algo extraño... bueno, ahora ya lo sabe 🙂

Licencia

Este proyecto está bajo la Licencia MIT - consulte el archivo LICENSE para obtener más detalles.

Agradecimientos

• Construido con Model Context Protocol (MCP)