feat(app): wire Android MCP through CLI, menu, and create flow

Add --mcp-android / --no-mcp-android flags, mcp-android subcommand parser,
interactive create-flow prompt + display-settings row, and propagate
enableMcpAndroid through frontend-lib config, web create draft, and API
client request body. Mirrors the existing Playwright MCP integration.

REF: issue-436

Author: konard

packages/app/src/docker-git/api-client-create.ts

@@ -41,6 +41,7 @@ export const buildCreateProjectRequest = (
     dockerNetworkMode: config.dockerNetworkMode,
     dockerSharedNetworkName: config.dockerSharedNetworkName,
     enableMcpPlaywright: config.enableMcpPlaywright,
+    enableMcpAndroid: config.enableMcpAndroid ?? false,
     outDir: command.outDir,
     gitTokenLabel: config.gitTokenLabel,
     skipGithubAuth: config.skipGithubAuth,

packages/app/src/docker-git/cli/parser-apply.ts

@@ -40,6 +40,7 @@ export const parseApply = (
       playwrightCpuLimit,
       playwrightRamLimit,
       gpu,
-      enableMcpPlaywright: raw.enableMcpPlaywright
+      enableMcpPlaywright: raw.enableMcpPlaywright,
+      enableMcpAndroid: raw.enableMcpAndroid
     }
   })

packages/app/src/docker-git/cli/parser-mcp-android.ts

@@ -0,0 +1,24 @@
+import { Either } from "effect"
+
+import { type McpAndroidUpCommand, type ParseError } from "../frontend-lib/core/domain.js"
+
+import { parseProjectDirWithOptions } from "./parser-shared.js"
+
+// CHANGE: parse "mcp-android" command for existing docker-git projects
+// WHY: allow enabling Android MCP in an already created container/project dir
+// QUOTE(ТЗ): "Подключить mcp-android так же как работает MCP PLAYRIGHT"
+// REF: issue-436
+// SOURCE: n/a
+// FORMAT THEOREM: forall argv: parseMcpAndroid(argv) = cmd -> deterministic(cmd)
+// PURITY: CORE
+// EFFECT: Effect<McpAndroidUpCommand, ParseError, never>
+// INVARIANT: projectDir is never empty
+// COMPLEXITY: O(n) where n = |argv|
+export const parseMcpAndroid = (
+  args: ReadonlyArray<string>
+): Either.Either<McpAndroidUpCommand, ParseError> =>
+  Either.map(parseProjectDirWithOptions(args), ({ projectDir, raw }) => ({
+    _tag: "McpAndroidUp",
+    projectDir,
+    runUp: raw.up ?? true
+  }))

packages/app/src/docker-git/cli/parser-options.ts

@@ -110,6 +110,8 @@ const booleanFlagUpdaters: Readonly<Record<string, (raw: RawOptions) => RawOptio
   "--force-env": (raw) => ({ ...raw, forceEnv: true }),
   "--mcp-playwright": (raw) => ({ ...raw, enableMcpPlaywright: true }),
   "--no-mcp-playwright": (raw) => ({ ...raw, enableMcpPlaywright: false }),
+  "--mcp-android": (raw) => ({ ...raw, enableMcpAndroid: true }),
+  "--no-mcp-android": (raw) => ({ ...raw, enableMcpAndroid: false }),
   "--wipe": (raw) => ({ ...raw, wipe: true }),
   "--no-wipe": (raw) => ({ ...raw, wipe: false }),
   "--web": (raw) => ({ ...raw, authWeb: true }),

packages/app/src/docker-git/cli/parser.ts

@@ -7,6 +7,7 @@ import { parseAttach } from "./parser-attach.js"
 import { parseAuth } from "./parser-auth.js"
 import { parseClone } from "./parser-clone.js"
 import { buildCreateCommand } from "./parser-create.js"
+import { parseMcpAndroid } from "./parser-mcp-android.js"
 import { parseMcpPlaywright } from "./parser-mcp-playwright.js"
 import { parseOpen } from "./parser-open.js"
 import { parseRawOptions } from "./parser-options.js"
@@ -93,6 +94,7 @@ export const parseArgs = (args: ReadonlyArray<string>): Either.Either<Command, P
       Match.when("sessions", () => parseSessions(rest)),
       Match.when("scrap", () => parseScrap(rest)),
       Match.when("mcp-playwright", () => parseMcpPlaywright(rest)),
+      Match.when("mcp-android", () => parseMcpAndroid(rest)),
       Match.when("help", () => Either.right(helpCommand)),
       Match.when("ps", () => Either.right(statusCommand)),
       Match.when("status", () => Either.right(statusCommand)),

packages/app/src/docker-git/cli/usage.ts

@@ -7,6 +7,7 @@ docker-git clone <url> [options]
 docker-git open [<selector>] [options]
 docker-git apply [<url>] [options]
 docker-git mcp-playwright [<url>] [options]
+docker-git mcp-android [<url>] [options]
 docker-git attach [<project-dir>] [options]
 docker-git panes [<url>] [options]
 docker-git scrap <action> [<url>] [options]
@@ -27,6 +28,7 @@ Commands:
   open                Open an existing docker-git project by selector, URL, or path
   apply               Apply docker-git config to an existing project/container (current dir by default)
   mcp-playwright      Enable Playwright MCP + nested Chromium browser for an existing project dir
+  mcp-android         Enable Android MCP (mobile-mcp) + nested Android emulator for an existing project dir
   attach, tmux        Attach to an existing docker-git project workspace with tmux
   panes, terms        List tmux panes for a docker-git project
   scrap               Export/import project scrap (session snapshot + rebuildable deps)
@@ -78,6 +80,7 @@ Options:
   --up | --no-up            Run docker compose up after init (default: --up)
   --ssh | --no-ssh          Auto-open SSH after create/clone (default: clone=--ssh, create=--no-ssh)
   --mcp-playwright | --no-mcp-playwright  Enable Rust browser MCP + noVNC/CDP session (default: --no-mcp-playwright)
+  --mcp-android | --no-mcp-android  Enable Android MCP (mobile-mcp) + nested Android emulator sidecar (default: --no-mcp-android)
   --auto[=claude|codex|gemini|grok]  Auto-execute an agent; without value picks by auth, random if multiple are available
   -d, --daemon             browser: run the browser frontend server in the background after build
   --active                  apply-all: apply only to currently running containers (skip stopped ones)

packages/app/src/docker-git/frontend-lib/core/command-builders-template.ts

@@ -20,6 +20,7 @@ export type BuildTemplateConfigInput = {
   readonly geminiAuthLabel: string | undefined
   readonly grokAuthLabel: string | undefined
   readonly enableMcpPlaywright: boolean
+  readonly enableMcpAndroid: boolean
   readonly agentMode: AgentMode | undefined
   readonly agentAuto: boolean
   /**
@@ -96,6 +97,7 @@ export const buildTemplateConfig = (input: BuildTemplateConfigInput): CreateComm
   dockerNetworkMode: input.dockerNetworkMode,
   dockerSharedNetworkName: input.dockerSharedNetworkName,
   enableMcpPlaywright: input.enableMcpPlaywright,
+  enableMcpAndroid: input.enableMcpAndroid,
   bunVersion: defaultTemplateConfig.bunVersion,
   agentMode: input.agentMode,
   agentAuto: input.agentAuto,

packages/app/src/docker-git/frontend-lib/core/command-builders.ts

@@ -201,6 +201,7 @@ type CreateBehavior = {
   readonly force: boolean
   readonly forceEnv: boolean
   readonly enableMcpPlaywright: boolean
+  readonly enableMcpAndroid: boolean
 }
 
 const resolveCreateBehavior = (raw: RawOptions): CreateBehavior => ({
@@ -209,7 +210,8 @@ const resolveCreateBehavior = (raw: RawOptions): CreateBehavior => ({
   skipGithubAuth: raw.skipGithubAuth ?? false,
   force: raw.force ?? false,
   forceEnv: raw.forceEnv ?? false,
-  enableMcpPlaywright: raw.enableMcpPlaywright ?? false
+  enableMcpPlaywright: raw.enableMcpPlaywright ?? false,
+  enableMcpAndroid: raw.enableMcpAndroid ?? false
 })
 
 type TokenLabelConfig = {
@@ -277,6 +279,7 @@ export const buildCreateCommand = (
         ...tokenLabels,
         skipGithubAuth: behavior.skipGithubAuth,
         enableMcpPlaywright: behavior.enableMcpPlaywright,
+        enableMcpAndroid: behavior.enableMcpAndroid,
         agentMode,
         agentAuto: isAgentAuto,
         clonedOnHostname: raw.clonedOnHostname

packages/app/src/docker-git/frontend-lib/core/command-options.ts

@@ -34,6 +34,7 @@ export interface RawOptions {
   readonly dockerNetworkMode?: string
   readonly dockerSharedNetworkName?: string
   readonly enableMcpPlaywright?: boolean
+  readonly enableMcpAndroid?: boolean
   readonly archivePath?: string
   readonly scrapMode?: string
   readonly wipe?: boolean

packages/app/src/docker-git/frontend-lib/core/domain.ts

@@ -114,6 +114,7 @@ export interface TemplateConfig {
   readonly dockerNetworkMode: DockerNetworkMode
   readonly dockerSharedNetworkName: string
   readonly enableMcpPlaywright: boolean
+  readonly enableMcpAndroid?: boolean | undefined
   readonly bunVersion: string
   readonly agentMode?: AgentMode | undefined
   readonly agentAuto?: boolean | undefined
@@ -204,6 +205,12 @@ export interface McpPlaywrightUpCommand {
   readonly runUp: boolean
 }
 
+export interface McpAndroidUpCommand {
+  readonly _tag: "McpAndroidUp"
+  readonly projectDir: string
+  readonly runUp: boolean
+}
+
 export interface ApplyCommand {
   readonly _tag: "Apply"
   readonly projectDir: string
@@ -219,6 +226,7 @@ export interface ApplyCommand {
   readonly playwrightRamLimit?: string | undefined
   readonly gpu?: GpuMode | undefined
   readonly enableMcpPlaywright?: boolean | undefined
+  readonly enableMcpAndroid?: boolean | undefined
 }
 
 // CHANGE: add apply-all command to apply docker-git config to every known project; support --active flag
@@ -262,6 +270,7 @@ export type Command =
   | SessionsCommand
   | ScrapCommand
   | McpPlaywrightUpCommand
+  | McpAndroidUpCommand
   | ApplyCommand
   | ApplyAllCommand
   | HelpCommand