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

Related MCP server: Kotlin MCP Server

What It Does

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

Tools (24 total)

Knowledge Layer (14)

Android CLI Integration Layer (5)

*Requires Android Studio running with Gemini signed in.

Execution Layer (4)

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