feat(container): add first-party Android MCP module

.changeset/mcp-android-integration.md

@@ -0,0 +1,14 @@
+---
+"@prover-coder-ai/docker-git": minor
+---
+
+Add Android MCP integration alongside the existing Playwright MCP support (issue #436).
+
+Projects can now opt into a nested Android emulator sidecar driven by the
+first-party Rust `android-connection` MCP server, mirroring how Playwright MCP works. Enable it
+with the new `--mcp-android` / `--no-mcp-android` create flags, the `mcp-android`
+subcommand, the interactive create-flow prompt, or the `enableMcpAndroid` field
+on the web/API create-project request. When enabled, the generated
+`docker-compose.yml` adds a gated `docker-android` emulator service (KVM,
+ADB port forwarding, headless CI mode) and the agent MCP config writers register
+the Android server so it coexists with Playwright.

.github/workflows/check.yml

@@ -39,6 +39,26 @@ jobs:
       - name: Build (api)
         run: bun run --cwd packages/api build
 
+  rust-android-connection:
+    name: Rust Android connection
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+      - name: Rust version
+        run: |
+          rustc --version
+          cargo --version
+      - name: Format
+        working-directory: crates/android-connection
+        run: cargo fmt --check
+      - name: Test
+        working-directory: crates/android-connection
+        run: cargo test --locked
+      - name: Clippy
+        working-directory: crates/android-connection
+        run: cargo clippy --locked --all-targets -- -D warnings
+
   dist-deps-prune:
     name: Dist deps prune
     runs-on: ubuntu-latest

README.md

@@ -71,6 +71,7 @@ bun run  docker-git clone https://github.com/ProverCoderAI/docker-git/issues/122
 
 - `--force` пересоздаёт окружение и удаляет volumes проекта.
 - `--mcp-playwright` включает Playwright MCP и Chromium sidecar для браузерной автоматизации.
+- `--mcp-android` включает first-party Android MCP (`android-connection`) и вложенный sidecar с Android-эмулятором (`docker-android`) для мобильной автоматизации.
 
 Автоматический запуск агента:
 

crates/android-connection/.gitignore

@@ -0,0 +1 @@
+target/

crates/android-connection/Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "docker-git-android-connection"
+version = "0.1.0"
+edition = "2021"
+description = "First-party Android MCP and lifecycle module for docker-git"
+license = "MIT"
+repository = "https://github.com/ProverCoderAI/docker-git"
+
+[lib]
+name = "docker_git_android_connection"
+path = "src/lib.rs"
+
+[[bin]]
+name = "docker-git-android-connection"
+path = "src/main.rs"
+
+[[bin]]
+name = "android-connection"
+path = "src/bin/android-connection.rs"
+
+[dependencies]
+clap = { version = "4.5.53", features = ["derive"] }
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.145"

crates/android-connection/README.md

@@ -0,0 +1,10 @@
+# docker-git Android connection
+
+First-party Android MCP module for docker-git.
+
+The crate provides two binaries:
+
+- `android-connection`: MCP stdio server used by Codex, Claude, Gemini, and Grok.
+- `docker-git-android-connection`: lifecycle CLI for deterministic Android runtime naming and Docker command construction.
+
+The core module keeps deterministic naming, endpoint validation, and tool specifications pure. Shell effects are isolated in the binaries and MCP tool handlers.

crates/android-connection/src/bin/android-connection.rs

@@ -0,0 +1,54 @@
+use clap::Parser;
+use docker_git_android_connection::mcp::{run_stdio, McpState};
+use docker_git_android_connection::{
+    android_spec, DEFAULT_ADB_ENDPOINT, DEFAULT_ANDROID_IMAGE, DEFAULT_PROJECT_ID,
+};
+use std::io::{self, BufReader};
+use std::path::PathBuf;
+use std::process::ExitCode;
+
+#[derive(Parser, Debug)]
+#[command(version, about = "Android MCP stdio server for docker-git")]
+struct Cli {
+    #[arg(long, default_value = DEFAULT_PROJECT_ID)]
+    project: String,
+    #[arg(long, default_value = "docker-git-shared")]
+    network: String,
+    #[arg(long, default_value = DEFAULT_ADB_ENDPOINT)]
+    endpoint: String,
+    #[arg(long, default_value = DEFAULT_ANDROID_IMAGE)]
+    image: String,
+    #[arg(long, default_value = ".")]
+    workspace: PathBuf,
+    #[arg(long)]
+    allow_install: bool,
+    #[arg(long)]
+    no_adb_probe: bool,
+}
+
+fn main() -> ExitCode {
+    match run() {
+        Ok(()) => ExitCode::SUCCESS,
+        Err(error) => {
+            eprintln!("{error}");
+            ExitCode::from(1)
+        }
+    }
+}
+
+fn run() -> Result<(), Box<dyn std::error::Error>> {
+    let cli = Cli::parse();
+    let spec = android_spec(&cli.project, &cli.network, &cli.endpoint, &cli.image)?;
+    let state = McpState {
+        spec,
+        workspace: cli.workspace,
+        adb_probe: !cli.no_adb_probe,
+        allow_install: cli.allow_install,
+    };
+    let stdin = io::stdin();
+    let stdout = io::stdout();
+    let mut reader = BufReader::new(stdin.lock());
+    let mut writer = stdout.lock();
+    run_stdio(&mut reader, &mut writer, state)?;
+    Ok(())
+}