ADB MCP Server

Implementation Reference

• src/index.ts:727-742 (handler)

  The handler function for the 'adb_activity_manager' tool. It validates the input, builds device-specific arguments, splits additional am arguments, and executes the 'adb shell am [command] [args]' command using the shared executeAdbCommand helper.
  async (args: z.infer<typeof AdbActivityManagerSchema>, _extra: RequestHandlerExtra) => { log(LogLevel.INFO, `Executing Activity Manager command: am ${args.amCommand} ${args.amArgs || ''}`); const deviceArgs = buildDeviceArgs(args.device); const amCommand = args.amCommand.trim(); if (!amCommand) { const message = "Activity Manager command must not be empty"; log(LogLevel.ERROR, message); return { content: [{ type: "text" as const, text: message }], isError: true }; } const additionalArgs = args.amArgs ? splitCommandArguments(args.amArgs) : []; return executeAdbCommand([...deviceArgs, "shell", "am", amCommand, ...additionalArgs], "Error executing Activity Manager command"); },
• src/types.ts:86-90 (schema)

  Zod schema definition for the input parameters of the adb_activity_manager tool: amCommand (required), amArgs (optional), device (optional).
  export const adbActivityManagerSchema = z.object({ amCommand: z.string().describe("Activity Manager subcommand, e.g. 'start', 'broadcast', 'force-stop', etc."), amArgs: z.string().optional().describe("Arguments for the am subcommand, e.g. '-a android.intent.action.VIEW'"), device: z.string().optional().describe("Specific device ID (optional)") });
• src/index.ts:724-744 (registration)

  Registration of the 'adb_activity_manager' tool on the MCP server using server.tool(), providing the tool name, input schema, inline handler function, and description.
  server.tool( "adb_activity_manager", AdbActivityManagerSchema.shape, async (args: z.infer<typeof AdbActivityManagerSchema>, _extra: RequestHandlerExtra) => { log(LogLevel.INFO, `Executing Activity Manager command: am ${args.amCommand} ${args.amArgs || ''}`); const deviceArgs = buildDeviceArgs(args.device); const amCommand = args.amCommand.trim(); if (!amCommand) { const message = "Activity Manager command must not be empty"; log(LogLevel.ERROR, message); return { content: [{ type: "text" as const, text: message }], isError: true }; } const additionalArgs = args.amArgs ? splitCommandArguments(args.amArgs) : []; return executeAdbCommand([...deviceArgs, "shell", "am", amCommand, ...additionalArgs], "Error executing Activity Manager command"); }, { description: ADB_ACTIVITY_MANAGER_TOOL_DESCRIPTION } );
• src/types.ts:110-110 (schema)

  Export of the AdbActivityManagerSchema, which is used in the tool registration in src/index.ts.
  export const AdbActivityManagerSchema = adbActivityManagerSchema;
• src/index.ts:289-338 (helper)

  Helper function splitCommandArguments used in the handler to parse the amArgs string into an array of arguments, handling quotes and escapes.
  function splitCommandArguments(value: string): string[] { const args: string[] = []; let current = ""; let inSingleQuote = false; let inDoubleQuote = false; let escapeNext = false; for (const char of value) { if (escapeNext) { current += char; escapeNext = false; continue; } if (char === "\\") { escapeNext = true; continue; } if (char === "'" && !inDoubleQuote) { inSingleQuote = !inSingleQuote; continue; } if (char === '"' && !inSingleQuote) { inDoubleQuote = !inDoubleQuote; continue; } if (/\s/.test(char) && !inSingleQuote && !inDoubleQuote) { if (current.length > 0) { args.push(current); current = ""; } continue; } current += char; } if (escapeNext) { current += "\\"; } if (current.length > 0) { args.push(current); } return args; }