replicant-mcp — Claude Code MCP server: install
An MCP server for AI-driven Android work: build APKs, operate emulators, exercise UIs, and inspect filtered logs.
claude mcp add replicant-mcp -- npx -y replicant-mcpWhat replicant-mcp does
replicant-mcp connects an Android development setup to an AI assistant through MCP. It can build APKs and bundles, run unit or instrumented tests, enumerate modules and build variants, and compare test results with a baseline.
The server handles emulators and attached devices, including creation, startup, reset, snapshots, app installation, launch, stopping, and data clearing. For UI tasks it relies on the accessibility tree, locates controls by text or position, enters text, taps elements, and captures screenshots.
Logcat can be narrowed by package, tag, severity, or time. The package also exposes replicant doctor for environment checks and configurable structured logs. Node.js 18+, the Android SDK with adb and emulator on PATH, and gradlew for project builds are required; without them, the Android workflows will not run.
What it helps with
- build an APK or app bundle
- run unit and instrumented tests
- install an app on an emulator
- locate and tap UI elements
- filter logcat for one app
Example prompts for the agent
- Build the debug app, install it on the emulator, and launch it.
- Walk through checkout with a test product and verify the confirmation screen.
- Inspect the filtered logs for the crash and explain its cause.
How to install replicant-mcp
Platform CLI
claude mcp add replicant-mcp -- npx -y replicant-mcpPlatform CLI
codex mcp add replicant-mcp -- npx -y replicant-mcpConfig file
{
"mcpServers": {
"replicant-mcp": {
"command": "npx",
"args": [
"-y",
"replicant-mcp"
]
}
}
}Config file
{
"servers": {
"replicant-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"replicant-mcp"
]
}
}
}Platform CLI
gemini mcp add replicant-mcp npx -y replicant-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about replicant-mcp
How do I install replicant-mcp in Claude Code?
Run claude mcp add replicant-mcp -- npx -y replicant-mcp.
What does replicant-mcp do?
It lets an AI assistant build and test Android apps, control emulators and devices, operate app UIs, manage installed packages, and inspect filtered logcat output.
What does replicant-mcp require?
You need Node.js 18+, the Android SDK with adb and emulator available on PATH, plus gradlew for Android project builds.
