Dev Tools for Android (DTA) MCP

Herramientas de Desarrollo para Android (DTA)

Un conjunto de herramientas que brinda a los asistentes de IA acceso directo a dispositivos Android mediante el Protocolo de Contexto de Modelo (MCP). Tu agente de codificación puede ver la pantalla, leer el tráfico de red, inspeccionar árboles de diseño, simular respuestas e interactuar con la aplicación, ya sea desde Android Studio, la terminal o cualquier cliente MCP.

Artículo: Depuración de aplicaciones Android con IA

Inicio rápido

Opción A: Complemento de Android Studio

O bien: Configuración → Complementos → Mercado → buscar "DTA"

El complemento integra el daemon, inyecta automáticamente sidekick en compilaciones de depuración y proporciona un inspector de 4 pestañas (Diseño, Red, WebSocket, MCP); no se necesita CLI ni configuración manual.

Opción B: CLI

brew tap yamsergey/packages
brew install dta-cli

Requisitos: Java 21+

Inyección automática (recomendada)

No se necesitan cambios en el proyecto. Utiliza la CLI o la herramienta MCP run_app para compilar y lanzar tu aplicación con sidekick inyectado automáticamente:

dta-cli run --project /path/to/your/android/project

Esto ejecuta Gradle con un script de inicio que añade dta-sidekick como dependencia de debugImplementation, compila el APK, lo instala en el dispositivo y lanza la actividad principal. Tu asistente de IA puede hacer lo mismo mediante la herramienta MCP run_app.

Manual (alternativa)

Si prefieres añadir sidekick directamente a tus archivos de compilación:

dependencies {
    debugImplementation 'io.github.yamsergey:dta-sidekick:0.9.36'
}

Sidekick se autoinicializa mediante AndroidX Startup; no se necesitan cambios de código más allá de la dependencia.

Conecta tu asistente de IA

Con el complemento de AS: abre la pestaña MCP, habilita el servidor, elige tu agente en el menú desplegable: muestra el fragmento de configuración exacto para copiar y pegar. Funciona con Claude Code, Cursor, Android Studio Gemini, Claude Desktop, VS Code y otros.

Sin el complemento (solo CLI):

Claude Code

claude mcp add dta -- dta-cli mcp

Cursor

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dta": {
      "command": "dta-cli",
      "args": ["mcp"]
    }
  }
}

¿Qué puede hacer tu agente?

Análisis de pantalla

DTA devuelve la jerarquía real de la interfaz: clases de vistas, límites, posiciones, parámetros de diseño, datos específicos de Compose (nombres de composables, recuentos de recomposición) y árboles DOM de WebViews y Custom Tabs de Chrome. A diferencia de adb shell uiautomator dump, que proporciona un árbol de accesibilidad semántico, tu agente obtiene la imagen completa.

Análisis de red

Sidekick registra automáticamente desde el inicio de la aplicación: solicitudes HTTP (OkHttp), conexiones WebSocket, tráfico de Custom Tabs de Chrome y solicitudes de red de WebView. No hay botón de "iniciar grabación" ni solicitudes perdidas. Tu agente puede consultar el historial completo en cualquier momento.

Simulación (Mocking)

Crea reglas de simulación para HTTP y WebSocket a partir de datos capturados o desde cero. Conecta adaptadores personalizados para control programático:

Sidekick.configure(
    SidekickConfig.builder()
        .httpMockAdapter { transaction, proposedResponse ->
            proposedResponse.withBody("""{"message": "mocked"}""")
        }
        .build()
)

Compilar y lanzar

La herramienta run_app compila un APK con sidekick inyectado automáticamente, lo instala y lanza la actividad principal, todo desde una sola llamada MCP. No se requiere configuración manual de Gradle. Si la herramienta está bloqueada por el entorno de pruebas de tu sistema, devuelve los comandos exactos de shell como alternativa.

Verificación

El agente puede tocar, deslizar, ingresar texto y presionar teclas, y luego verificar el estado de la pantalla y el tráfico de red para confirmar el comportamiento. Un bucle completo de inspección, simulación, interacción y verificación sin salir de la conversación.

Complemento de Android Studio

La ventana de herramientas del Inspector DTA proporciona cuatro pestañas:

Pestaña	Características
Diseño	Árbol de interfaz + captura de pantalla del dispositivo con resaltado al pasar el cursor, selección con clic, sincronización de selección bidireccional
Red	Tabla de solicitudes HTTP con encabezados, cuerpos, tiempos; tráfico de Custom Tabs y WebView
WebSocket	Lista de conexiones → lista de mensajes → detalle del mensaje
MCP	Habilitar servidor HTTP, elegir puerto, fragmentos de configuración por agente con copiar al portapapeles

El complemento inyecta automáticamente dta-sidekick en compilaciones de depuración mediante un script de inicio de Gradle; no se requieren cambios en los archivos de tu proyecto.

Interfaz web del Inspector

dta-cli inspector-web

Abre http://localhost:8080 para inspección visual con las mismas capacidades: árbol de diseño, red, WebSocket, editor de reglas de simulación.

El inspector web permite comunicación bidireccional entre desarrollador y agente: selecciona elementos con un clic en lugar de describirlos con palabras.

Transportes MCP

Transporte	Comando	Caso de uso
stdio	dta-cli mcp	Claude Desktop, Cursor, cualquier cliente MCP stdio
HTTP	dta-cli mcp serve --http --port 12321	AS Gemini, Claude Code HTTP, cualquier cliente Streamable HTTP
Complemento	Habilitar en la pestaña MCP	Servidor HTTP integrado en AS, no se necesita CLI

Módulos

Módulo	Descripción
dta-plugin	Complemento de Android Studio (inspector de 4 pestañas + daemon integrado + servidor MCP)
dta-cli	Interfaz CLI (comandos mcp, inspector-web, run, inspect)
dta-mcp	Servidor MCP (transporte stdio + HTTP, definiciones de herramientas)
dta-daemon	Daemon HTTP de Javalin (conexión sidekick, observador CDP, enriquecimiento de diseño)
dta-sidekick	Biblioteca de inspección en la aplicación (AAR de Android, autoinicio mediante AndroidX Startup)
tools-android	Integración central de la API de herramientas de Gradle
workspace-kotlin	Convertidor de workspace.json para Kotlin Language Server

Referencia de CLI

dta-cli --help
dta-cli <command> --help

Licencia

Apache License 2.0: consulta LICENSE.txt