Android Puppeteer

Instructions

Implementation Reference

• puppeteer.py:238-331 (handler)

  The handler function decorated with @mcp.tool() that implements the list_emulators tool. It uses ADB to list connected devices/emulators, fetches additional info like AVD name/model and screen dimensions, and returns a structured list.
  @mcp.tool() async def list_emulators() -> dict: """List all available Android emulators and devices with their name, ID, status, and dimensions""" try: # Execute adb devices to get connected devices/emulators result = subprocess.run(['adb', 'devices'], capture_output=True, text=True, check=True) devices = [] lines = result.stdout.strip().split('\n')[1:] # Skip header line for line in lines: if line.strip(): parts = line.strip().split('\t') if len(parts) >= 2: device_id = parts[0] status = parts[1] # Try to get AVD name if it's an emulator avd_name = "Unknown" if device_id.startswith('emulator-'): try: avd_result = subprocess.run( ['adb', '-s', device_id, 'emu', 'avd', 'name'], capture_output=True, text=True, timeout=5 ) if avd_result.returncode == 0: avd_name = avd_result.stdout.strip() except (subprocess.TimeoutExpired, subprocess.CalledProcessError): pass else: # For physical devices, try to get device model try: model_result = subprocess.run( ['adb', '-s', device_id, 'shell', 'getprop', 'ro.product.model'], capture_output=True, text=True, timeout=5 ) if model_result.returncode == 0: avd_name = model_result.stdout.strip() except (subprocess.TimeoutExpired, subprocess.CalledProcessError): pass # Get device dimensions width, height, dimensions = None, None, None try: size_result = subprocess.run( ['adb', '-s', device_id, 'shell', 'wm', 'size'], capture_output=True, text=True, timeout=5 ) if size_result.returncode == 0: output = size_result.stdout.strip() if 'Physical size:' in output: size_part = output.split('Physical size:')[1].strip() width, height = map(int, size_part.split('x')) dimensions = f"{width}x{height}" except (subprocess.TimeoutExpired, subprocess.CalledProcessError, ValueError): pass devices.append({ "id": device_id, "name": avd_name, "status": status, "type": "emulator" if device_id.startswith('emulator-') else "device", "width": width, "height": height, "dimensions": dimensions }) return { "success": True, "devices": devices, "count": len(devices) } except subprocess.CalledProcessError as e: return { "success": False, "error": f"Failed to execute adb command: {e}", "devices": [], "count": 0 } except FileNotFoundError: return { "success": False, "error": "ADB not found. Please ensure Android SDK is installed and adb is in PATH.", "devices": [], "count": 0 } except Exception as e: return { "success": False, "error": f"Unexpected error: {e}", "devices": [], "count": 0 }
• puppeteer.py:238-238 (registration)

  The @mcp.tool() decorator registers the list_emulators function as an MCP tool.
  @mcp.tool()