The replicant-mcp server enables AI assistants to comprehensively manage Android development environments through natural language commands, automating build, test, deployment, and UI testing workflows.

Capabilities include:

• Build & Test: Build debug/release APKs/bundles, run unit and instrumented tests, introspect project structure (modules, variants, tasks), and retrieve detailed logs/errors from previous operations

• Emulator Management: List, create, start, stop, and wipe Android Virtual Devices; manage snapshots (save, load, list, delete) for quick state restoration

• Device Control: List connected devices, select active device, query device properties, and wait for device availability

• App Management: Install, uninstall, launch, stop apps; clear app data and list installed packages

• Log Analysis: Read and filter logcat output by package, tag, level, time range, or custom filters with progressive disclosure (summaries first, full details on demand)

• UI Automation: Dump accessibility tree, find elements by text/properties, tap by coordinates/index, input text, capture screenshots, and perform accessibility checks

• Shell Commands: Execute ADB shell commands with safety guards to prevent dangerous operations

• Server Utilities: Manage internal cache (stats, clear, configure) and access built-in documentation via rtfm for any tool or category

• Token-Efficient Design: Progressive disclosure minimizes token usage while maintaining full access to detailed output when needed

Provides tools for interacting with the Android development environment, including emulator management, application installation, ADB shell command execution, Logcat log analysis, and UI automation via the accessibility tree.

Enables automated interaction with the Gradle build system to assemble APKs and bundles, run unit or instrumented tests, and retrieve detailed build results and logs.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@replicant-mcp Build the debug APK and run it on the emulator"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.