android_execute_command
Execute custom ADB commands on Android devices to perform device management, debugging, and automation tasks through the Android MCP Server.
Instructions
Execute a generic ADB command with custom arguments. Allows agents to run any ADB command with their own parameters.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | Yes | Array of ADB command arguments (e.g., ["shell", "pm", "list", "packages"] or ["logcat", "-d", "-s", "MyTag"]) | |
| deviceSerial | No | Specific device serial number to target (optional) |
Implementation Reference
- src/handlers.ts:724-749 (handler)Main handler function for 'android_execute_command' tool. Validates input args, executes the ADB command via ADBWrapper.executeCommand, and formats stdout/stderr as response content.
export async function handleExecuteCommand(adb: ADBWrapper, args: ExecuteCommandArgs): Promise<{ content: Array<{ type: string; text: string }> }> { const { args: adbArgs, deviceSerial } = args; if (!adbArgs || !Array.isArray(adbArgs) || adbArgs.length === 0) { throw new Error('args parameter is required and must be a non-empty array'); } try { const { stdout, stderr } = await adb.executeCommand(adbArgs, deviceSerial); let output = ''; if (stdout) output += `stdout:\n${stdout}`; if (stderr) output += `${output ? '\n\n' : ''}stderr:\n${stderr}`; return { content: [ { type: 'text', text: output || 'Command executed successfully (no output)', }, ], }; } catch (error) { throw new Error(`Failed to execute ADB command: ${error instanceof Error ? error.message : String(error)}`); } } - src/index.ts:435-454 (schema)JSON schema definition for the 'android_execute_command' tool input, including required 'args' array and optional 'deviceSerial'.
name: 'android_execute_command', description: 'Execute a generic ADB command with custom arguments. Allows agents to run any ADB command with their own parameters.', inputSchema: { type: 'object', properties: { args: { type: 'array', items: { type: 'string', }, description: 'Array of ADB command arguments (e.g., ["shell", "pm", "list", "packages"] or ["logcat", "-d", "-s", "MyTag"])', }, deviceSerial: { type: 'string', description: 'Specific device serial number to target (optional)', }, }, required: ['args'], }, }, - src/index.ts:506-507 (registration)Registration of the tool handler in the MCP server's CallToolRequestSchema switch statement, dispatching to handleExecuteCommand.
case 'android_execute_command': return await handleExecuteCommand(this.adb, args as any); - src/adb-wrapper.ts:416-419 (helper)Helper method in ADBWrapper that executes the generic ADB command by calling the private exec method, handling device targeting.
async executeCommand(args: string[], deviceSerial?: string): Promise<{ stdout: string; stderr: string }> { const device = deviceSerial ? await this.getTargetDevice(deviceSerial) : undefined; return await this.exec(args, device); } - src/handlers.ts:719-722 (schema)TypeScript interface defining the input arguments for the handleExecuteCommand function.
interface ExecuteCommandArgs { args: string[]; deviceSerial?: string; }