Replicant

Provides an MCP server that enables Claude to build, emulate, install, test, and debug Android apps via natural language.

typescript

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thecombatwombat-replicant-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/replicant-mcp/dist/index.js"
      ],
      "env": {
        "PATH": "$HOME/Library/Android/sdk/platform-tools:$HOME/Library/Android/sdk/emulator:$HOME/Library/Android/sdk/cmdline-tools/latest/bin:$PATH",
        "ANDROID_HOME": "$HOME/Library/Android/sdk"
      }
    }
  }
}

You install and run an MCP server that lets Claude interact with your Android development workflow. This server translates natural language requests into actions like building APKs, starting emulators, managing apps, and debugging crashes, making Android development faster and more interactive.

How to use

You use an MCP client (Claude Desktop or Claude Code) to connect to the Replicant MCP Server. Once connected, you can ask Claude to build, run tests, manage emulators, install apps, and inspect logs with natural language prompts. Claude will map your requests to specific tools, run them, and return summaries or results. If more detail is needed, you can request the full logs or specific outputs.

How to install

Prerequisites to run the server and connect to Claude:

Node.js 18+
Android SDK with adb and emulator in your PATH
An Android project with gradlew for builds.

Install the MCP server globally or run from source:
- Option 1: npm (recommended)
  - Run the command below to install globally:
  - ```bash
    npm install -g replicant-mcp
    ```
- Option 2: From source
  - ```bash
    git clone https://github.com/thecombatwombat/replicant-mcp.git
    cd replicant-mcp
    npm install
    npm run build
    npm test

Configuration and connection

Connect Claude Desktop to the MCP server by configuring the MCP server entry to run as a local process with Node. The server will run from your machine and expose commands Claude can invoke.

Here is the explicit configuration to run the server in a local stdio mode. This starts node and points to the built server entry.

Available tools

gradle-build

Build APKs and bundles (assembleDebug, assembleRelease, bundle).

gradle-test

Run unit and instrumented tests with filtering.

gradle-list

List modules, build variants, and tasks.

gradle-get-details

Fetch full logs and errors from cached build results.

emulator-device

Create, start, stop emulators and manage snapshots.

adb-device

List devices, select the active device, and query properties.

adb-app

Install, uninstall, launch, stop apps; clear app data.

adb-logcat

Read filtered device logs by package, tag, level, or time.

adb-shell

Run shell commands with safety guards.

ui

Interact with the accessibility tree: find elements, tap, input text, and take screenshots as needed.

cache

Manage cached outputs, including stats and configuration.

rtfm

On-demand documentation for tools and capabilities.

Built by

VeilStrat

AI signals for GTM teams