Android UI Assist MCP Server

Instructions

Implementation Reference

• src/server.ts:50-54 (registration)

  Registration of the 'list_android_devices' tool in the ListToolsRequestHandler, including name, description, and input schema reference.
  { name: 'list_android_devices', description: 'List all connected Android devices and emulators', inputSchema: ListDevicesToolSchema, },
• src/server.ts:83-94 (handler)

  Tool dispatch handler for 'list_android_devices': parses input, calls listDevices method, and formats response as JSON text.
  case 'list_android_devices': { const input = ListDevicesInputSchema.parse(args); const result = await this.listDevices(input); return { content: [ { type: 'text', text: JSON.stringify(result), }, ], }; }
• src/server.ts:130-148 (handler)

  Private listDevices method: fetches devices using getConnectedDevices helper, maps fields, and validates output schema.
  private async listDevices( input: z.infer<typeof ListDevicesInputSchema> ): Promise<z.infer<typeof ListDevicesOutputSchema>> { const devices = getConnectedDevices(); const result = { devices: devices.map(device => ({ id: device.id, status: device.status, model: device.model, product: device.product, transportId: device.transportId, usb: device.usb, productString: device.productString, })), }; return ListDevicesOutputSchema.parse(result); }
• src/types.ts:120-134 (schema)

  Output schema for list_android_devices tool defining the structure of the devices array.
  export const ListDevicesOutputSchema = z.object({ devices: z .array( z.object({ id: z.string().describe('Device ID'), status: z.string().describe('Device status'), model: z.string().optional().describe('Device model'), product: z.string().optional().describe('Product name'), transportId: z.string().optional().describe('Transport ID'), usb: z.string().optional().describe('USB information'), productString: z.string().optional().describe('Product string'), }) ) .describe('List of connected Android devices'), });
• src/utils/adb.ts:120-138 (helper)

  Core helper function getConnectedDevices: executes 'adb devices -l', parses output, handles errors.
  export function getConnectedDevices(): AndroidDevice[] { try { const output = executeADBCommand('devices -l'); const devices = parseDeviceList(output); if (devices.length === 0) { throw new NoDevicesFoundError(); } return devices; } catch (error) { if (error instanceof NoDevicesFoundError) { throw error; } throw new ADBCommandError('FAILED_TO_LIST_DEVICES', 'Failed to list connected devices', { originalError: error instanceof Error ? error.message : String(error), }); } }