android-dev-mcp

Unified MCP server for Android mobile development — combines project knowledge, Android CLI execution, live dependency versions, and agentic workflow tools for Claude Code.

Install

curl -fsSL https://raw.githubusercontent.com/maheshmishra271090-design/android-dev-mcp/main/scripts/install.sh | bash

That's it. No cloning, no manual steps. The installer handles everything:

• Node.js ≥ 18 (installs or upgrades)
• Git + ITGD aliases
• Android CLI + Google Android Skills
• android-dev-mcp global npm package
• MCP config for Claude Code (via claude mcp add) and Claude Desktop (via claude_desktop_config.json)
• CLAUDE.md block in current project
• Git hooks (pre-commit lint + commit-msg Conventional Commits)

android-dev-mcp init registers the server in both places it can be used — the claude CLI's own MCP config (for Claude Code / the VSCode extension) and claude_desktop_config.json (for the Claude Desktop app). If the claude CLI isn't on PATH, Claude Code registration is skipped with a warning and the manual command to run instead (see below).

After install — verify

android-dev-mcp check

  MCP server built:    ✔
  Claude configured:   ✔
  Android CLI:         ✔  android 1.x.x
  CLAUDE.md (cwd):     ✔  block present

claude mcp get android-dev-mcp

android-dev-mcp:
  Status: ✔ Connected
  Type: stdio
  Command: node
  Args: <path-to-package>/dist/index.js

Then inside Claude Code, start a new session (registration only takes effect on session start):

/mcp   → should show android-dev-mcp with 24 tools

Manual registration (Claude Code)

If init reports it couldn't find the claude CLI, or you're setting this up without the installer, register it directly:

claude mcp add android-dev-mcp -- node "$(npm root -g)/@maheshmishra271090-design/android-dev-mcp/dist/index.js"

Or, when working from a local clone/checkout of this repo:

npm run build
claude mcp add android-dev-mcp -- node "$(pwd)/dist/index.js"

Remove it with:

claude mcp remove android-dev-mcp -s local

---

What It Does

One MCP server that gives Claude Code both the knowledge and the execution power to complete full Android development workflows autonomously:

Layer	Tools	What it provides
Knowledge	14	MVVM, Hilt, Compose, ExoPlayer, Retrofit, tests, git, prompts, model routing
Android CLI	5	Scaffold, lint, render @Preview, deploy APK, live dep versions
Execution	4	Direct adb, git, gradle, and shell command execution

Tools (24 total)

Knowledge Layer (14)

Tool	Returns
get_full_context	All 14 knowledge domains — call at session start
get_project_structure	Module layout, package naming, file conventions
get_architecture_patterns	MVVM, Hilt, ViewModel, StateFlow, Coroutines
get_ui_compose_standards	Compose screens, Material 3, Navigation, Player UI
get_api_backend_patterns	Retrofit, AuthInterceptor, DTO mapping, error codes
get_player_patterns	ExoPlayer/Media3, HLS, Widevine DRM, lifecycle
get_cicd_commands	Gradle flavors, signing, CI pipeline
check_ui_fluidity	Frame rate · jank · recomposition · ACR crash analysis
generate_tests	ViewModel · Repository · Compose UI · API templates
get_git_workflow	Branch strategy, Conventional Commits, hooks
get_prompt_templates	Ask CIO, few-shot CoT, compact tasks
get_session_hygiene	/clear vs /compact, context window rules
get_model_routing	Haiku/Sonnet/Opus routing + task recommendation
get_tooling_setup	Graphify, RTK, Caveman, Superpowers guides

Android CLI Integration Layer (5)

Tool	What it does
get_android_cli_guide	Full CLI command reference + workflow protocols
run_android_cli	Executes any android command, returns stdout
get_live_versions	Current agp/kotlin/compose/media3 from Google Maven*
scaffold_feature	Context + live versions + CLI scaffold in one call
verify_ui	Renders @Preview + validates against ITGD Compose standards*
fluidity_debug_workflow	Full debug protocol: ADB + layout tree + screenshot + ACR + lint

*Requires Android Studio running with Gemini signed in.

Execution Layer (4)

Tool	What it does
run_adb	Executes any adb command, returns stdout
run_git	Executes any git command, returns stdout
run_gradle	Executes a Gradle task — uses ./gradlew if present, else global gradle
run_bash	Executes an arbitrary shell command, returns stdout/stderr

Agentic Workflows

New Feature

get_full_context → get_live_versions → scaffold_feature → studio analyze-file → verify_ui → android run

Fluidity Debug

fluidity_debug_workflow("player") → android layout --diff → android screen capture → ACR → fix → verify

New Developer Onboarding

curl -fsSL https://raw.githubusercontent.com/maheshmishra271090-design/android-dev-mcp/main/scripts/install.sh | bash
# Done in ~3 minutes — no pair session needed

Per-Project CLAUDE.md

To add or update the MCP block in any project:

android-dev-mcp setup-claude-md                       # current project
android-dev-mcp setup-claude-md --dir=~/projects/App  # specific project

Safe to re-run — never overwrites existing content.

Customising Knowledge

All knowledge is plain markdown in knowledge/. Edit to match your project.

License

MIT