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-emulator-mcp

¿Por qué replicant-mcp?

Características

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

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

MIT

¿Preguntas? Abre un issue

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• adb-appC
• adb-deviceC
• adb-logcatC
• adb-shellC
• cacheD
• emulator-deviceC
• gradle-buildD
• gradle-get-detailsC