# replicant-mcp

An MCP server for AI-driven Android work: build APKs, operate emulators, exercise UIs, and inspect filtered logs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: thecombatwombat
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thecombatwombat/replicant-mcp
- Updated: 2026-07-26
- HTML: https://affpapa.org/en/nevibecode/mcp/replicant-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add replicant-mcp -- npx -y replicant-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add replicant-mcp -- npx -y replicant-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "replicant-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "replicant-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "replicant-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "replicant-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add replicant-mcp npx -y replicant-mcp
```

## When to use it
- 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
- 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.

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9751
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5149

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md