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

android-dev-mcp

android-dev-mcp

Install

After install — verify

Manual registration (Claude Code)

What It Does

Tools (24 total)

Knowledge Layer (14)

Android CLI Integration Layer (5)

Execution Layer (4)

Agentic Workflows

New Feature

Fluidity Debug

New Developer Onboarding

Per-Project CLAUDE.md

Customising Knowledge

License

Latest Blog Posts

MCP directory API