Servidor MCP de Android ADB

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA interactuar con dispositivos Android a través del Puente de Depuración de Android (ADB). Este servidor conecta las capacidades de IA con la gestión de dispositivos Android, permitiendo una automatización fluida de las operaciones de desarrollo y pruebas de Android.

⚙️ Configuración rápida

Agregue el servidor a su archivo de configuración MCP:

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Ubicaciones de configuración

Escritorio de Claude : ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Código Cline/Roo : ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json (macOS)
Para Windows/Linux, consulte los directorios de soporte de aplicaciones equivalentes

Después de la configuración, reinicie su asistente de IA para cargar la nueva configuración del servidor.

📋 Requisitos previos

ADB (Android Debug Bridge) debe estar instalado y disponible en la RUTA de su sistema
- Instalar ADB en Windows, macOS o Linux
- Verifique la instalación ejecutando adb version en su terminal
Para la funcionalidad del portapapeles:
- macOS : osascript (integrado)
- Windows : PowerShell (integrado)
- Linux : xclip (instalación mediante apt-get install xclip o equivalente)
Node.js 16.x o superior

🚀 Características

Conéctese y administre varios dispositivos Android
Ejecutar comandos de shell en dispositivos Android
Instalar y desinstalar aplicaciones
Enviar y recibir archivos entre el sistema local y los dispositivos Android
Iniciar aplicaciones en dispositivos Android
Tome capturas de pantalla y guárdelas localmente o cópielas al portapapeles
Selección de dispositivo inteligente cuando hay varios dispositivos conectados

🛠️ Herramientas disponibles

Herramienta	Descripción	Parámetros requeridos	Parámetros opcionales
`adb_devices`	Lista de dispositivos conectados	Ninguno	Ninguno
`adb_shell`	Ejecutar comandos de shell	`command`	`device_id`
`adb_install`	Instalar archivos APK	`path`	`device_id`
`adb_uninstall`	Desinstalar aplicaciones	`package_name`	`device_id`
`adb_list_packages`	Lista de paquetes instalados	Ninguno	`device_id` , `filter`
`adb_pull`	Extraer archivos del dispositivo	`remote_path` , `local_path`	`device_id`
`adb_push`	Enviar archivos al dispositivo	`local_path` , `remote_path`	`device_id`
`launch_app`	Iniciar una aplicación	`package_name`	`device_id`
`take_screenshot_and_save`	Tomar y guardar captura de pantalla	`output_path`	`device_id` , `format`
`take_screenshot_and_copy_to_clipboard`	Tomar captura de pantalla al portapapeles	Ninguno	`device_id` , `format`

Administración de dispositivos

El servidor gestiona de forma inteligente la selección de dispositivos:

Si solo hay un dispositivo conectado, se utilizará automáticamente
Si hay varios dispositivos conectados, debe especificar un parámetro device_id
Si no hay dispositivos conectados, se devolverá un error.

Resolución de ruta de captura de pantalla

Al especificar output_path para guardar capturas de pantalla, la ruta se resuelve de la siguiente manera:

Las rutas absolutas se utilizan tal cual
Las rutas que comienzan con ~ se expanden al directorio de inicio del usuario
Las rutas relativas se resuelven en relación con el directorio de inicio del usuario.

Esto garantiza que las capturas de pantalla se guarden en una ubicación donde el servidor MCP tenga permisos de escritura.

🔍 Solución de problemas

Problemas comunes

Error "ADB no está disponible"
- Asegúrese de que ADB esté instalado y en la RUTA de su sistema
- Verifique ejecutando adb version en su terminal
Error "No hay dispositivos Android conectados"
- Comprueba si tu dispositivo está conectado correctamente con adb devices
- Asegúrese de que la depuración USB esté habilitada en su dispositivo
- Intente reiniciar ADB con adb kill-server seguido de adb start-server
Error "Varios dispositivos conectados"
- Especifique el parámetro device_id en su llamada de herramienta
- Obtenga la lista de dispositivos disponibles con la herramienta adb_devices
La captura de pantalla al portapapeles no funciona
- Asegúrese de que estén instaladas las herramientas específicas de la plataforma requeridas

🔧 Métodos de instalación alternativos

Opción 1: Instalar desde npm

# Install globally
npm install -g @landicefu/android-adb-mcp-server

# Or install locally in your project
npm install @landicefu/android-adb-mcp-server

Opción 2: Instalación manual desde la fuente

Clonar el repositorio:
git clone https://github.com/landicefu/android-adb-mcp-server.git cd android-adb-mcp-server
Instalar dependencias y compilar:
npm install npm run build
Configurar con ruta directa:
{ "mcpServers": { "android-adb": { "command": "node", "args": ["/path/to/android-adb-mcp-server/build/index.js"], "env": {}, "disabled": false, "alwaysAllow": [] } } }

📄 Licencia

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

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Android ADB MCP Server

Integrations