Claude Desktop marketplace package is stale (v0.1.0) — crashes on startup when no device connected

[gorzko]

Problem

The .mcpb extension package distributed through the Claude Desktop connector directory is outdated. It ships v0.1.0 (timestamped 2026-02-12), while master has significantly advanced.

What the packaged version does wrong

In the bundled __main__.py, Mobile() and device are instantiated at module level:

mobile = Mobile(device=args.device if args.device else 'emulator-5554')
device = mobile.get_device()

This means the server crashes at Python import time if no device is connected — before the MCP handshake even completes. Claude Desktop sees an immediate disconnect and reports "Server disconnected."

The lifespan context manager is defined in that version but never passed to FastMCP, so it has no effect.

Additionally, the package pins .python-version = 3.13. If the user removed Python 3.13 (e.g. upgraded to 3.14), uv cannot build the venv and installation silently fails — leaving orphaned dxt-install-* staging directories in %APPDATA%\Claude\.

What master already has (and the marketplace package doesn't)

• mobile = Mobile() with deferred connection via require_device() / _connect_preferred_device()
• lifespan=lifespan correctly wired into FastMCP
• ListDevices, ConnectDevice, Device tools
• WiFi ADB support (--wifi, ANDROID_MCP_HOST)
• ClickBySelector, WaitForElement tools
• Environment variable config (ANDROID_MCP_DEVICE, ANDROID_MCP_CONNECTION)

Impact

Users installing via the Claude Desktop UI — the primary advertised install path — get the broken v0.1.0 package. The server never connects unless a device happens to be online at the exact moment Claude Desktop starts, and even then it hard-codes emulator-5554. This is also related to #10.

Workaround (for affected users)

1. Quit Claude Desktop
2. Delete orphaned staging dirs: Remove-Item "$env:APPDATA\Claude\dxt-install-*" -Recurse -Force
3. Install Python 3.13 via uv if needed: uv python install 3.13
4. Manually extract the .mcpb to %APPDATA%\Claude\Claude Extensions\ant.dir.gh.cursortouch.android-mcp\
5. Pre-build the venv: cd <ext-dir> && uv run android-mcp --help
6. Register the extension manually in extensions-installations.json and Claude Extensions Settings\
7. Restart Claude Desktop — it will connect since the venv is already built

Request

Please publish an updated .mcpb to the Claude Desktop connector directory reflecting the current master. The fix is already done in code — it just needs to be re-packaged and re-submitted to the marketplace.

Environment

• Windows 11, Claude Desktop (Windows Store) v1.12603.1.0
• Python 3.13.13 (via uv managed), uv 0.x latest
• Bundled .mcpb package hash: 4d2d266ba5b4a4d0273b0cfc34a6c092cd1042320833f4521934450d515671b6