AndroClaudio

Give Claude/Codex/Cursor Code instant live knowledge of your running Android app — no source files read, no credentials exposed, zero production overhead.

Claude Code connects to an MCP server embedded in your debug APK. It discovers your app's classes and public functions, calls them live on the emulator, and verifies full feature flows using intelligent mock responses. When you're ready, flip individual groups to live mode for real API testing.

How It Works

Your project                    AndroClaudio
────────────────                ──────────────────────────────────────────
groups.json          ──KSP──▶  Generated_*Registry.kt   (compile time)
Application.onCreate ──────▶   MCP server starts on port 5173  (runtime)
adb forward tcp:5173 ──────▶   Claude Code calls /tools/list + /tools/call

Three components, zero production impact:

debugImplementation means the AAR is completely absent from release builds — no code, no size, no overhead.

Requirements

• Android minSdk 21+
• Kotlin 1.9+
• KSP plugin 1.9.23-1.0.20 or newer
• Node.js 18+ (setup CLI, one time only)

Quick Start

# 1. Scan your project
npx androplaudio-setup --project-dir . --output androplaudio-groups.json

# 2. Add files, configure Gradle, add one line to Application (see below)

# 3. Build
./gradlew assembleDebug

# 4. Forward port
adb forward tcp:5173 tcp:5173

# 5. Verify
curl http://localhost:5173/tools/list | jq .

Integration — Android App

Step 1 — Copy library files

Download from releases/1.0.0/ and place in your app module:

your-app/
└── app/
    └── libs/
        ├── androplaudio-core-1.0.0.aar   ← runtime MCP server (debug only)
        └── androplaudio-ksp-1.0.0.jar    ← KSP code generator (build time only)

Step 2 — Configure Gradle

app/build.gradle.kts

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.devtools.ksp") version "1.9.23-1.0.20"   // add if not present
}

ksp {
    // path to the groups.json you generated in the previous step
    arg("androplaudio.groupsJson", "${rootDir}/androplaudio-groups.json")
}

dependencies {
    // KSP processor — runs at build time only, generates call registries
    ksp(files("libs/androplaudio-ksp-1.0.0.jar"))

    // Runtime MCP server — debug builds only, completely absent from release
    debugImplementation(files("libs/androplaudio-core-1.0.0.aar"))
}

If you already have the KSP plugin, just add the two dependency lines and the ksp { } block.

Step 3 — Run the setup CLI

npx androplaudio-setup --project-dir /path/to/your/app --output androplaudio-groups.json

This scans your project and writes androplaudio-groups.json. It detects your DI framework automatically (Koin, Hilt, Dagger, or manual) and finds every registered class.

Example output:

{
  "version": "1",
  "platform": "android",
  "framework": "koin",
  "groups": [
    { "id": "payment.repository", "layer": "shared", "class": "com.myapp.data.PaymentRepository" },
    { "id": "order.use.case",     "layer": "shared", "class": "com.myapp.domain.OrderUseCase" },
    { "id": "cart.manager",       "layer": "shared", "class": "com.myapp.domain.CartManager" }
  ]
}

Re-run whenever you add a new class. The file is plain JSON — you can also edit it manually.

Step 4 — Add one line to your Application class

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        // your existing DI setup — co

... [View full README on GitHub](https://github.com/Atul206/androidclaudio#readme)