replicant-mcp
replicant-mcp
Deja que la IA compile, pruebe y depure tus aplicaciones Android.
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

Related MCP server: android-adb-mcp
¿Por qué replicant-mcp?
Sin replicant-mcp | Con replicant-mcp |
"Ejecuta | "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 |
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
adbyemulatoren tu PATHUn 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 versionInstalación
npm install -g replicant-mcpDespués de la instalación, ejecuta los diagnósticos integrados para verificar tu entorno:
replicant doctorActualización
npm update -g replicant-mcpConfiguració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-mcpCursor
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-mcpNota: Asegúrate de que
adbyemulatorestén en tu PATH, o establece la variable de entornoANDROID_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_CONFIGpara opciones avanzadas. Consulta docs/configuration.md.Registro: Establece
REPLICANT_LOG_LEVEL(error,warn,info,debug) yREPLICANT_LOG_FORMAT(jsonpara 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
rtfmcon una categoría como "build", "adb", "emulator" o "ui".
Documentación
Documento | Descripción |
Resumen del diseño y patrón de divulgación progresiva | |
Referencia del archivo de configuración, variables de entorno, configuración de Gradle | |
Política de versiones de la API de herramientas y proceso de obsolescencia | |
Modelo de seguridad de adb-shell, lista de denegación de comandos, límites de amenazas | |
Versiones probadas de SO, Node.js, Android SDK y emulador | |
Brechas de accesibilidad, tiempos de espera, enfoque en un solo dispositivo y más | |
Contenido del directorio | |
Problemas comunes y soluciones | |
Historial de versiones | |
Proceso de notificación de vulnerabilidades | |
Cómo informar errores y hacer preguntas | |
Configuración de desarrollo y directrices |
Contribución
Consulta CONTRIBUTING.md para la configuración de desarrollo y las directrices.
Agradecimientos
Inspirado en xc-mcp para iOS
Construido sobre el Protocolo de Contexto de Modelo (MCP)
Licencia
¿Preguntas? Abre un issue
Available Tools
14 toolsadb-appCDestructive
Manage applications.
Inputs: operation (required), apkPath, packageName, limit, +2 more.
adb-deviceC
Manage device connections.
Inputs: operation (required), deviceId.
adb-logcatCRead-onlyIdempotent
Read device logs. Returns summary with logId.
Inputs: lines (required), package, tags, level, +2 more.
adb-shellCDestructive
Execute shell commands with safety guards.
Inputs: command (required), timeout, maxChars, summaryOnly, +1 more.
cacheDDestructive
Manage the cache. See rtfm for details.
Inputs: operation (required), key, config.
emulator-deviceCDestructive
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-detailsCRead-onlyIdempotent
Fetch full output for a previous build/test by ID.
Inputs: id (required), detailType (required), maxChars, summaryOnly, +1 more.
gradle-listBRead-onlyIdempotent
Introspect project structure.
Inputs: operation (required), module.
gradle-testADestructive
Run tests. Returns summary with testId. With baseline, auto-detects regressions.
Inputs: operation (required), module, filter, taskName.
rtfmARead-onlyIdempotent
Get documentation. Pass category ('build'|'adb'|'emulator'|'ui'|'cache'|'index') or tool (tool name like 'ui-query').
Inputs: category, tool.
ui-actionADestructive
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-queryCRead-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
Scored across 14 tools
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.
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.
14 tools is well-scoped for an Android development/testing MCP, covering ADB, Gradle, emulators, UI, cache, and documentation without being overwhelming.
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
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceAn 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.3MIT
- FlicenseAqualityDmaintenanceAn MCP server designed for Android development, enabling AI assistants to directly control Android devices for screenshots, UI analysis, app management, and more.19-
- AlicenseBqualityCmaintenanceA 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.907MIT