Skip to main content
Glama

replicant-mcp

Deja que la IA compile, pruebe y depure tus aplicaciones Android.

CI npm Node.js License: MIT Ask DeepWiki replicant-mcp MCP server

replicant-mcp es un servidor del Protocolo de Contexto de Modelo (MCP) que brinda a los asistentes de IA como Claude la capacidad de interactuar con tu entorno de desarrollo de Android. Compila APKs, inicia emuladores, instala aplicaciones, navega por interfaces de usuario y depura errores, todo a través de una conversación natural.


Demo

replicant-mcp demo


Related MCP server: android-adb-mcp

¿Por qué replicant-mcp?

Sin replicant-mcp

Con replicant-mcp

"Ejecuta ./gradlew assembleDebug, luego adb install, luego adb shell am start..."

"Compila y ejecuta la aplicación"

Copiar y pegar la salida de logcat, perder el contexto

La IA lee los registros filtrados directamente

Captura de pantalla → describir UI → adivinar coordenadas

La IA ve el árbol de accesibilidad, toca elementos por texto

5,000 tokens de salida cruda de Gradle

Resumen de 50 tokens + detalles bajo demanda


Características

Categoría

Capacidades

Compilación y pruebas

Compilar APKs/bundles, ejecutar pruebas unitarias e instrumentadas, listar módulos/variantes/tareas, probar detección de regresión con comparación de línea base

Emulador

Crear, iniciar, detener, limpiar emuladores; guardar/cargar/eliminar instantáneas

Control de dispositivos

Listar dispositivos conectados, seleccionar dispositivo activo, consultar propiedades del dispositivo

Gestión de aplicaciones

Instalar, desinstalar, iniciar, detener aplicaciones; borrar datos de la aplicación

Análisis de registros

Filtrar logcat por paquete, etiqueta, nivel, tiempo

Automatización de UI

Búsqueda de elementos basada en accesibilidad, búsqueda de proximidad espacial, toque, entrada de texto, capturas de pantalla

Diagnóstico

Comprobaciones de salud del entorno mediante replicant doctor; registro estructurado con nivel y formato configurables


Próximamente

  • Comandos de compilación personalizados (anulaciones específicas del proyecto, detección automática de gradlew)

  • Captura de video (iniciar/detener grabación, captura basada en duración)


Inicio rápido

Requisitos previos

  • Node.js 18+

  • Android SDK con adb y emulator en tu PATH

  • Un proyecto Android con gradlew (para herramientas de compilación)

node --version      # Should be 18+
adb --version       # Should show Android Debug Bridge version
emulator -version   # Should show Android emulator version

Instalación

npm install -g replicant-mcp

Después de la instalación, ejecuta los diagnósticos integrados para verificar tu entorno:

replicant doctor

Actualización

npm update -g replicant-mcp

Configuración

Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Claude Code

claude mcp add replicant -- npx -y replicant-mcp

Cursor

Añádelo a ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

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

Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json:

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

OpenAI Codex CLI

Añádelo a ~/.codex/config.toml:

[mcp_servers.replicant]
command = "npx"
args = ["-y", "replicant-mcp"]

O mediante CLI:

codex mcp add replicant -- npx -y replicant-mcp

Nota: Asegúrate de que adb y emulator estén en tu PATH, o establece la variable de entorno ANDROID_HOME. En macOS: ~/Library/Android/sdk, en Linux: ~/Android/Sdk.


Ejemplo

You: "I just changed the checkout flow. Build the app, go through checkout
      with a test product, and make sure the confirmation screen shows up."

Claude: [Builds debug APK, installs on emulator, launches app]
        [Taps "Electronics" category → "Wireless Headphones" → "Add to Cart"]
        [Navigates to cart, taps "Checkout"]
        [Fills shipping form, taps "Place Order"]

        Confirmation screen is showing:
        - Order #38291
        - "Wireless Headphones" × 1
        - Total: $79.99
        - Estimated delivery: Jan 30

        The flow works. Want me to test the edge cases—empty cart,
        invalid address, payment failure?

Diseño

replicant-mcp utiliza divulgación progresiva (resúmenes primero, detalles bajo demanda) para minimizar el uso de tokens, y automatización de UI basada en accesibilidad para interacciones más rápidas, económicas y fiables que los enfoques basados en capturas de pantalla. Consulta docs/architecture.md para más detalles.


Más información

  • Configuración: Establece REPLICANT_CONFIG para opciones avanzadas. Consulta docs/configuration.md.

  • Registro: Establece REPLICANT_LOG_LEVEL (error, warn, info, debug) y REPLICANT_LOG_FORMAT (json para salida estructurada) para controlar el registro del servidor. Los registros se escriben en stderr.

  • Solución de problemas: Problemas comunes y soluciones en docs/troubleshooting.md.

  • Documentación de herramientas: Pídele a Claude que ejecute rtfm con una categoría como "build", "adb", "emulator" o "ui".


Documentación

Documento

Descripción

Arquitectura

Resumen del diseño y patrón de divulgación progresiva

Configuración

Referencia del archivo de configuración, variables de entorno, configuración de Gradle

Estabilidad de la API

Política de versiones de la API de herramientas y proceso de obsolescencia

Modelo de seguridad

Modelo de seguridad de adb-shell, lista de denegación de comandos, límites de amenazas

Matriz de soporte

Versiones probadas de SO, Node.js, Android SDK y emulador

Limitaciones conocidas

Brechas de accesibilidad, tiempos de espera, enfoque en un solo dispositivo y más

Artefactos

Contenido del directorio .replicant/ y consideraciones de privacidad

Solución de problemas

Problemas comunes y soluciones

Registro de cambios

Historial de versiones

Política de seguridad

Proceso de notificación de vulnerabilidades

Soporte / Obtener ayuda

Cómo informar errores y hacer preguntas

Contribución

Configuración de desarrollo y directrices


Contribución

Consulta CONTRIBUTING.md para la configuración de desarrollo y las directrices.


Agradecimientos


Licencia

MIT


¿Preguntas? Abre un issue

Available Tools

14 tools
adb-appC
Destructive

Manage applications.

Inputs: operation (required), apkPath, packageName, limit, +2 more.

adb-deviceC

Manage device connections.

Inputs: operation (required), deviceId.

adb-logcatC
Read-onlyIdempotent

Read device logs. Returns summary with logId.

Inputs: lines (required), package, tags, level, +2 more.

adb-shellC
Destructive

Execute shell commands with safety guards.

Inputs: command (required), timeout, maxChars, summaryOnly, +1 more.

cacheD
Destructive

Manage the cache. See rtfm for details.

Inputs: operation (required), key, config.

emulator-deviceC
Destructive

Manage Android emulators.

Inputs: operation (required), avdName, device, systemImage, +2 more.

gradle-buildD

Build. Returns summary with buildId.

Inputs: operation (required), module, flavor.

gradle-get-detailsC
Read-onlyIdempotent

Fetch full output for a previous build/test by ID.

Inputs: id (required), detailType (required), maxChars, summaryOnly, +1 more.

gradle-listB
Read-onlyIdempotent

Introspect project structure.

Inputs: operation (required), module.

gradle-testA
Destructive

Run tests. Returns summary with testId. With baseline, auto-detects regressions.

Inputs: operation (required), module, filter, taskName.

rtfmA
Read-onlyIdempotent

Get documentation. Pass category ('build'|'adb'|'emulator'|'ui'|'cache'|'index') or tool (tool name like 'ui-query').

Inputs: category, tool.

ui-actionA
Destructive

Interact with app UI: tap, input, scroll. Use selector or coords.

Inputs: operation (required), x, y, elementIndex, +5 more.

ui-captureC

Capture screenshots or visual snapshots.

Inputs: operation (required), localPath, inline, maxDimension, +1 more.

ui-queryC
Read-onlyIdempotent

Query app UI. Accessibility-first.

Inputs: operation (required), selector, debug, maxTier, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: adb-* for device management, gradle-* for build/test, ui-* for UI interaction, and separate tools for cache, docs, and emulators. No functional overlap.

    Naming Consistency4/5

    Names consistently use domain prefixes (adb-, gradle-, ui-), but gradle-get-details introduces a hyphenated verb-noun while others use single verbs or nouns, a minor inconsistency.

    Tool Count5/5

    14 tools is well-scoped for an Android development/testing MCP, covering ADB, Gradle, emulators, UI, cache, and documentation without being overwhelming.

    Completeness4/5

    Covers essential Android development operations (device management, build/test, UI interaction). Missing some niche ADB commands (e.g., port forwarding) but core workflows are present.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A powerful MCP server that provides comprehensive Android device automation capabilities through ADB, enabling AI agents to interact with Android devices for testing, automation, and device control tasks.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that wraps Android ADB functionality into AI assistant tools, enabling device management, shell execution, file operations, app management, media capture, and log analysis via natural language.
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A comprehensive MCP server for Android Debug Bridge, enabling AI agents to control Android devices through structured tools like launching apps, UI automation, file operations, and log capture.
      90
      7
      MIT