ADB MCP Server

Implementation Reference

• src/index.ts:627-661 (handler)

  The core handler function for the 'adb_push' tool. It decodes the base64-encoded file input, writes it to a temporary local file, executes the 'adb push' command to transfer it to the specified remote path on the device (optionally targeting a specific device), handles the result or errors, and cleans up the temporary file.
  async (args: z.infer<typeof AdbPushSchema>, _extra: RequestHandlerExtra) => { log(LogLevel.INFO, `Pushing file to device: ${args.remotePath}`); const deviceArgs = buildDeviceArgs(args.device); const tempFilePath = createTempFilePath("adb-mcp", basename(args.remotePath)); try { // Decode the base64 file data and write to temporary file const fileData = Buffer.from(args.fileBase64, 'base64'); await writeFilePromise(tempFilePath, fileData); // Push the temporary file to the device const remotePath = args.remotePath.trim(); if (!remotePath) { throw new Error("Remote path must not be empty"); } const result = await executeAdbCommand([...deviceArgs, "push", tempFilePath, remotePath], "Error pushing file"); if (!result.isError) { log(LogLevel.INFO, `File pushed to device successfully: ${remotePath}`); } return result; } catch (error) { const errorMsg = error instanceof Error ? error.message : String(error); log(LogLevel.ERROR, `Error pushing file: ${errorMsg}`); return { content: [{ type: "text" as const, text: `Error pushing file: ${errorMsg}` }], isError: true }; } finally { // Clean up the temporary file await cleanupTempFile(tempFilePath); } },
• src/types.ts:68-72 (schema)

  Zod schema fields defining the input parameters for the adb_push tool: base64 file content, destination path on device, and optional device ID.
  export const adbPushInputSchema = { fileBase64: z.string().describe("Base64 encoded file content to push"), remotePath: z.string().describe("Remote file path on the device"), device: z.string().optional().describe("Specific device ID (optional)") };
• src/types.ts:107-107 (schema)

  Zod schema object construction for adb_push tool input validation using the defined input fields.
  export const AdbPushSchema = z.object(adbPushInputSchema);
• src/index.ts:624-662 (registration)

  Registration of the 'adb_push' tool with the MCP server, specifying the tool name, input schema shape, inline handler function, and tool description.
  server.tool( "adb_push", AdbPushSchema.shape, async (args: z.infer<typeof AdbPushSchema>, _extra: RequestHandlerExtra) => { log(LogLevel.INFO, `Pushing file to device: ${args.remotePath}`); const deviceArgs = buildDeviceArgs(args.device); const tempFilePath = createTempFilePath("adb-mcp", basename(args.remotePath)); try { // Decode the base64 file data and write to temporary file const fileData = Buffer.from(args.fileBase64, 'base64'); await writeFilePromise(tempFilePath, fileData); // Push the temporary file to the device const remotePath = args.remotePath.trim(); if (!remotePath) { throw new Error("Remote path must not be empty"); } const result = await executeAdbCommand([...deviceArgs, "push", tempFilePath, remotePath], "Error pushing file"); if (!result.isError) { log(LogLevel.INFO, `File pushed to device successfully: ${remotePath}`); } return result; } catch (error) { const errorMsg = error instanceof Error ? error.message : String(error); log(LogLevel.ERROR, `Error pushing file: ${errorMsg}`); return { content: [{ type: "text" as const, text: `Error pushing file: ${errorMsg}` }], isError: true }; } finally { // Clean up the temporary file await cleanupTempFile(tempFilePath); } }, { description: ADB_PUSH_TOOL_DESCRIPTION }
• src/index.ts:133-140 (helper)

  Detailed description string for the adb_push tool, used during registration to inform clients about its purpose and usage.
  * Tool description for adb-push */ const ADB_PUSH_TOOL_DESCRIPTION = "Transfers a file from the server to a connected Android device. " + "Useful for uploading test data, configuration files, media content, or any file needed on the device. " + "The file must be provided as base64-encoded content. " + "Requires specifying the full destination path on the device where the file should be placed. " + "Use this when setting up test environments, restoring backups, or modifying device files.";