appium-mcp 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.6.0](https://github.com/appium/appium-mcp/compare/v1.5.0...v1.6.0) (2025-12-22)
+
+### Features
+
+* **screenshot:** add configurable screenshot directory via SCREENSHOTS_DIR env var ([#54](https://github.com/appium/appium-mcp/issues/54)) ([f1957ad](https://github.com/appium/appium-mcp/commit/f1957ad0372d999db67f77b7b85a035546486b86))
+
+## [1.5.0](https://github.com/appium/appium-mcp/compare/v1.4.0...v1.5.0) (2025-12-19)
+
+### Features
+
+* **interactions:** add drag and drop tool for element and coordinate-based drag operations ([#55](https://github.com/appium/appium-mcp/issues/55)) ([571942e](https://github.com/appium/appium-mcp/commit/571942ecbd2d7ef395cc8e6a8aaf158dcf0f54fb))
+
 ## [1.4.0](https://github.com/appium/appium-mcp/compare/v1.3.0...v1.4.0) (2025-12-07)
 
 ### Features

package/README.md

@@ -157,6 +157,10 @@ Create a `capabilities.json` file to define your device capabilities:
 
 Set the `CAPABILITIES_CONFIG` environment variable to point to your configuration file.
 
+### Screenshots
+
+Set the `SCREENSHOTS_DIR` environment variable to specify where screenshots are saved. If not set, screenshots are saved to the current working directory. Supports both absolute and relative paths (relative paths are resolved from the current working directory). The directory is created automatically if it doesn't exist.
+
 ## 🎯 Available Tools
 
 MCP Appium provides a comprehensive set of tools organized into the following categories:
@@ -193,6 +197,7 @@ MCP Appium provides a comprehensive set of tools organized into the following ca
 | `appium_click`        | Click on an element                                                                          |
 | `appium_double_tap`   | Perform double tap on an element                                                             |
 | `appium_long_press`   | Perform a long press (press and hold) gesture on an element                                  |
+| `appium_drag_and_drop` | Perform a drag and drop gesture from a source location to a target location (supports element-to-element, element-to-coordinates, coordinates-to-element, and coordinates-to-coordinates) |
 | `appium_set_value`    | Enter text into an input field                                                               |
 | `appium_get_text`     | Get text content from an element                                                             |
 

package/dist/tests/screenshot.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/screenshot.test.js

@@ -0,0 +1,212 @@
+import { describe, test, expect, beforeEach, afterEach, jest, } from '@jest/globals';
+import { join, isAbsolute } from 'path';
+/**
+ * Local implementation of resolveScreenshotDir for testing.
+ * This mirrors the implementation in screenshot.ts to avoid importing
+ * the module which has heavy dependencies.
+ */
+function resolveScreenshotDir() {
+    const screenshotDir = process.env.SCREENSHOTS_DIR;
+    if (!screenshotDir) {
+        return process.cwd();
+    }
+    if (isAbsolute(screenshotDir)) {
+        return screenshotDir;
+    }
+    return join(process.cwd(), screenshotDir);
+}
+/**
+ * Local implementation of executeScreenshot for testing.
+ * This mirrors the implementation in screenshot.ts.
+ */
+async function executeScreenshot(deps) {
+    const driver = deps.getDriver();
+    if (!driver) {
+        throw new Error('No driver found');
+    }
+    try {
+        const screenshotBase64 = await driver.getScreenshot();
+        const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
+        const timestamp = deps.dateNow();
+        const filename = `screenshot_${timestamp}.png`;
+        const screenshotDir = deps.resolveScreenshotDir();
+        await deps.mkdir(screenshotDir, { recursive: true });
+        const filepath = join(screenshotDir, filename);
+        await deps.writeFile(filepath, screenshotBuffer);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Screenshot saved successfully to: ${filename}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to take screenshot. err: ${err.toString()}`,
+                },
+            ],
+        };
+    }
+}
+describe('resolveScreenshotDir', () => {
+    const originalEnv = process.env.SCREENSHOTS_DIR;
+    const cwd = process.cwd();
+    beforeEach(() => {
+        delete process.env.SCREENSHOTS_DIR;
+    });
+    afterEach(() => {
+        if (originalEnv !== undefined) {
+            process.env.SCREENSHOTS_DIR = originalEnv;
+        }
+        else {
+            delete process.env.SCREENSHOTS_DIR;
+        }
+    });
+    test('should return process.cwd() when SCREENSHOTS_DIR is not set', () => {
+        const result = resolveScreenshotDir();
+        expect(result).toBe(cwd);
+    });
+    test('should return process.cwd() when SCREENSHOTS_DIR is empty string', () => {
+        process.env.SCREENSHOTS_DIR = '';
+        const result = resolveScreenshotDir();
+        expect(result).toBe(cwd);
+    });
+    test('should return absolute path as-is when SCREENSHOTS_DIR is absolute', () => {
+        const absolutePath = '/tmp/screenshots';
+        process.env.SCREENSHOTS_DIR = absolutePath;
+        const result = resolveScreenshotDir();
+        expect(result).toBe(absolutePath);
+    });
+    test('should join relative path with process.cwd()', () => {
+        const relativePath = 'screenshots';
+        process.env.SCREENSHOTS_DIR = relativePath;
+        const result = resolveScreenshotDir();
+        expect(result).toBe(join(cwd, relativePath));
+    });
+    test('should handle nested relative paths', () => {
+        const relativePath = 'output/screenshots/test';
+        process.env.SCREENSHOTS_DIR = relativePath;
+        const result = resolveScreenshotDir();
+        expect(result).toBe(join(cwd, relativePath));
+    });
+    test('should handle relative path starting with ./', () => {
+        const relativePath = './screenshots';
+        process.env.SCREENSHOTS_DIR = relativePath;
+        const result = resolveScreenshotDir();
+        expect(result).toBe(join(cwd, relativePath));
+    });
+    test('should handle relative path with parent directory reference', () => {
+        const relativePath = '../screenshots';
+        process.env.SCREENSHOTS_DIR = relativePath;
+        const result = resolveScreenshotDir();
+        expect(result).toBe(join(cwd, relativePath));
+    });
+});
+describe('executeScreenshot', () => {
+    const mockBase64 = 'dGVzdA=='; // 'test' in base64
+    const mockTimestamp = 1234567890;
+    function createMockDeps(overrides = {}) {
+        return {
+            getDriver: jest.fn(() => ({
+                getScreenshot: jest.fn(() => Promise.resolve(mockBase64)),
+            })),
+            writeFile: jest.fn(() => Promise.resolve()),
+            mkdir: jest.fn(() => Promise.resolve()),
+            resolveScreenshotDir: jest.fn(() => '/mock/screenshots'),
+            dateNow: jest.fn(() => mockTimestamp),
+            ...overrides,
+        };
+    }
+    test('should throw error when no driver found', async () => {
+        const deps = createMockDeps({
+            getDriver: jest.fn(() => null),
+        });
+        await expect(executeScreenshot(deps)).rejects.toThrow('No driver found');
+    });
+    test('should return success content with filename', async () => {
+        const deps = createMockDeps();
+        const result = await executeScreenshot(deps);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: 'text',
+                    text: `Screenshot saved successfully to: screenshot_${mockTimestamp}.png`,
+                },
+            ],
+        });
+    });
+    test('should use resolved screenshot directory from SCREENSHOTS_DIR', async () => {
+        const customDir = '/custom/path/screenshots';
+        const deps = createMockDeps({
+            resolveScreenshotDir: jest.fn(() => customDir),
+        });
+        await executeScreenshot(deps);
+        expect(deps.mkdir).toHaveBeenCalledWith(customDir, { recursive: true });
+        expect(deps.writeFile).toHaveBeenCalledWith(join(customDir, `screenshot_${mockTimestamp}.png`), expect.any(Buffer));
+    });
+    test('should create directory with recursive option', async () => {
+        const deps = createMockDeps();
+        await executeScreenshot(deps);
+        expect(deps.mkdir).toHaveBeenCalledWith('/mock/screenshots', {
+            recursive: true,
+        });
+    });
+    test('should write screenshot buffer to correct filepath', async () => {
+        const deps = createMockDeps();
+        await executeScreenshot(deps);
+        expect(deps.writeFile).toHaveBeenCalledWith(`/mock/screenshots/screenshot_${mockTimestamp}.png`, Buffer.from(mockBase64, 'base64'));
+    });
+    test('should return error content when screenshot fails', async () => {
+        const errorMessage = 'Screenshot capture failed';
+        const deps = createMockDeps({
+            getDriver: jest.fn(() => ({
+                getScreenshot: jest.fn(() => Promise.reject(new Error(errorMessage))),
+            })),
+        });
+        const result = await executeScreenshot(deps);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+                },
+            ],
+        });
+    });
+    test('should return error content when mkdir fails', async () => {
+        const errorMessage = 'Permission denied';
+        const deps = createMockDeps({
+            mkdir: jest.fn(() => Promise.reject(new Error(errorMessage))),
+        });
+        const result = await executeScreenshot(deps);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+                },
+            ],
+        });
+    });
+    test('should return error content when writeFile fails', async () => {
+        const errorMessage = 'Disk full';
+        const deps = createMockDeps({
+            writeFile: jest.fn(() => Promise.reject(new Error(errorMessage))),
+        });
+        const result = await executeScreenshot(deps);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=screenshot.test.js.map

package/dist/tests/screenshot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.test.js","sourceRoot":"","sources":["../../src/tests/screenshot.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.js

@@ -16,6 +16,7 @@ import findElement from './interactions/find.js';
 import clickElement from './interactions/click.js';
 import doubleTap from './interactions/double-tap.js';
 import longPress from './interactions/long-press.js';
+import dragAndDrop from './interactions/drag-and-drop.js';
 import setValue from './interactions/set-value.js';
 import getText from './interactions/get-text.js';
 import getPageSource from './interactions/get-page-source.js';
@@ -107,6 +108,7 @@ export default function registerTools(server) {
     clickElement(server);
     doubleTap(server);
     longPress(server);
+    dragAndDrop(server);
     setValue(server);
     getText(server);
     getPageSource(server);

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/interactions/drag-and-drop.d.ts

@@ -0,0 +1,2 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function dragAndDrop(server: FastMCP): void;

package/dist/tools/interactions/drag-and-drop.js

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+import { getDriver, getPlatformName } from '../../session-store.js';
+import { elementUUIDScheme } from '../../schema.js';
+const DROP_PAUSE_DURATION_MS = 150;
+async function performDragAndDrop(driver, startX, startY, endX, endY, duration, longPressDuration) {
+    await driver.performActions([
+        {
+            type: 'pointer',
+            id: 'finger1',
+            parameters: { pointerType: 'touch' },
+            actions: [
+                { type: 'pointerMove', duration: 0, x: startX, y: startY },
+                { type: 'pointerDown', button: 0 },
+                { type: 'pause', duration: longPressDuration },
+                { type: 'pointerMove', duration: duration, x: endX, y: endY },
+                { type: 'pause', duration: DROP_PAUSE_DURATION_MS },
+                { type: 'pointerUp', button: 0 },
+            ],
+        },
+    ]);
+}
+export default function dragAndDrop(server) {
+    const dragAndDropSchema = z.object({
+        sourceElementUUID: elementUUIDScheme
+            .trim()
+            .min(1)
+            .optional()
+            .describe('UUID of the source element to drag from. Either sourceElementUUID or sourceX/sourceY must be provided.'),
+        sourceX: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Starting X coordinate. Required if sourceElementUUID is not provided.'),
+        sourceY: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Starting Y coordinate. Required if sourceElementUUID is not provided.'),
+        targetElementUUID: elementUUIDScheme
+            .trim()
+            .min(1)
+            .optional()
+            .describe('UUID of the target element to drop on. Either targetElementUUID or targetX/targetY must be provided.'),
+        targetX: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Ending X coordinate. Required if targetElementUUID is not provided.'),
+        targetY: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Ending Y coordinate. Required if targetElementUUID is not provided.'),
+        duration: z
+            .number()
+            .int()
+            .min(100)
+            .max(5000)
+            .default(1200)
+            .optional()
+            .describe('Duration of the drag movement in milliseconds. Default is 1200ms.'),
+        longPressDuration: z
+            .number()
+            .int()
+            .min(400)
+            .max(2000)
+            .default(600)
+            .optional()
+            .describe('Duration of the long press before dragging in milliseconds. Default is 600ms.'),
+    });
+    server.addTool({
+        name: 'appium_drag_and_drop',
+        description: `Perform a drag and drop gesture from a source location to a target location.
+      The gesture includes:
+      1. Long press (default 600ms, configurable) on the source to initiate drag mode
+      2. While holding, drag to the target location
+      3. Release at the target to complete the drop
+      
+      Supports four modes:
+      1. Element to Element: Drag from one element to another element
+      2. Element to Coordinates: Drag from an element to specific coordinates
+      3. Coordinates to Element: Drag from coordinates to an element
+      4. Coordinates to Coordinates: Drag from coordinates to coordinates
+      
+      This is useful for reordering lists, moving items, drag-to-delete, and other drag interactions.`,
+        parameters: dragAndDropSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No driver found');
+            }
+            try {
+                const platform = getPlatformName(driver);
+                const duration = args.duration || 1200;
+                const longPressDuration = args.longPressDuration || 600;
+                if (!args.sourceElementUUID &&
+                    (args.sourceX === undefined || args.sourceY === undefined)) {
+                    throw new Error('Either sourceElementUUID or both sourceX and sourceY must be provided.');
+                }
+                if (!args.targetElementUUID &&
+                    (args.targetX === undefined || args.targetY === undefined)) {
+                    throw new Error('Either targetElementUUID or both targetX and targetY must be provided.');
+                }
+                let startX, startY;
+                let endX, endY;
+                if (args.sourceElementUUID) {
+                    const rect = await driver.getElementRect(args.sourceElementUUID);
+                    startX = Math.floor(rect.x + rect.width / 2);
+                    startY = Math.floor(rect.y + rect.height / 2);
+                }
+                else {
+                    startX = args.sourceX;
+                    startY = args.sourceY;
+                }
+                if (args.targetElementUUID) {
+                    const rect = await driver.getElementRect(args.targetElementUUID);
+                    endX = Math.floor(rect.x + rect.width / 2);
+                    endY = Math.floor(rect.y + rect.height / 2);
+                }
+                else {
+                    endX = args.targetX;
+                    endY = args.targetY;
+                }
+                const { width, height } = await driver.getWindowSize();
+                if (startX < 0 || startX >= width || startY < 0 || startY >= height) {
+                    throw new Error(`Source coordinates (${startX}, ${startY}) are out of screen bounds (${width}x${height})`);
+                }
+                if (endX < 0 || endX >= width || endY < 0 || endY >= height) {
+                    throw new Error(`Target coordinates (${endX}, ${endY}) are out of screen bounds (${width}x${height})`);
+                }
+                if (platform === 'Android' || platform === 'iOS') {
+                    await performDragAndDrop(driver, startX, startY, endX, endY, duration, longPressDuration);
+                }
+                else {
+                    throw new Error(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
+                }
+                const sourceDesc = args.sourceElementUUID
+                    ? `element ${args.sourceElementUUID}`
+                    : `coordinates (${startX}, ${startY})`;
+                const targetDesc = args.targetElementUUID
+                    ? `element ${args.targetElementUUID}`
+                    : `coordinates (${endX}, ${endY})`;
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Successfully performed drag and drop from ${sourceDesc} to ${targetDesc}.`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to perform drag and drop. Error: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=drag-and-drop.js.map

package/dist/tools/interactions/drag-and-drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-and-drop.js","sourceRoot":"","sources":["../../../src/tools/interactions/drag-and-drop.ts"],"names":[],"mappings":"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"}

package/dist/tools/interactions/screenshot.d.ts

@@ -1,2 +1,20 @@
 import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+import { writeFile, mkdir } from 'fs/promises';
+/**
+ * Resolves the screenshot directory path.
+ * - If SCREENSHOTS_DIR is not set, returns process.cwd()
+ * - If SCREENSHOTS_DIR is absolute, returns it as-is
+ * - If SCREENSHOTS_DIR is relative, joins it with process.cwd()
+ */
+export declare function resolveScreenshotDir(): string;
+export interface ScreenshotDeps {
+    getDriver: () => {
+        getScreenshot: () => Promise<string>;
+    } | null;
+    writeFile: typeof writeFile;
+    mkdir: typeof mkdir;
+    resolveScreenshotDir: typeof resolveScreenshotDir;
+    dateNow: () => number;
+}
+export declare function executeScreenshot(deps?: ScreenshotDeps): Promise<any>;
 export default function screenshot(server: FastMCP): void;

package/dist/tools/interactions/screenshot.js

@@ -1,6 +1,67 @@
 import { getDriver } from '../../session-store.js';
-import { writeFile } from 'fs/promises';
-import { join } from 'path';
+import { writeFile, mkdir } from 'fs/promises';
+import { join, isAbsolute } from 'path';
+/**
+ * Resolves the screenshot directory path.
+ * - If SCREENSHOTS_DIR is not set, returns process.cwd()
+ * - If SCREENSHOTS_DIR is absolute, returns it as-is
+ * - If SCREENSHOTS_DIR is relative, joins it with process.cwd()
+ */
+export function resolveScreenshotDir() {
+    const screenshotDir = process.env.SCREENSHOTS_DIR;
+    if (!screenshotDir) {
+        return process.cwd();
+    }
+    if (isAbsolute(screenshotDir)) {
+        return screenshotDir;
+    }
+    return join(process.cwd(), screenshotDir);
+}
+const defaultDeps = {
+    getDriver,
+    writeFile,
+    mkdir,
+    resolveScreenshotDir,
+    dateNow: () => Date.now(),
+};
+export async function executeScreenshot(deps = defaultDeps) {
+    const driver = deps.getDriver();
+    if (!driver) {
+        throw new Error('No driver found');
+    }
+    try {
+        const screenshotBase64 = await driver.getScreenshot();
+        // Convert base64 to buffer
+        const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
+        // Generate filename with timestamp
+        const timestamp = deps.dateNow();
+        const filename = `screenshot_${timestamp}.png`;
+        const screenshotDir = deps.resolveScreenshotDir();
+        // Create a directory if it doesn't exist
+        await deps.mkdir(screenshotDir, { recursive: true });
+        const filepath = join(screenshotDir, filename);
+        // Save screenshot to disk
+        await deps.writeFile(filepath, screenshotBuffer);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Screenshot saved successfully to: ${filepath}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to take screenshot. err: ${err.toString()}`,
+                },
+            ],
+        };
+    }
+}
 export default function screenshot(server) {
     server.addTool({
         name: 'appium_screenshot',
@@ -9,41 +70,7 @@ export default function screenshot(server) {
             readOnlyHint: false,
             openWorldHint: false,
         },
-        execute: async (args, context) => {
-            const driver = getDriver();
-            if (!driver) {
-                throw new Error('No driver found');
-            }
-            try {
-                const screenshotBase64 = await driver.getScreenshot();
-                // Convert base64 to buffer
-                const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
-                // Generate filename with timestamp
-                const timestamp = Date.now();
-                const filename = `screenshot_${timestamp}.png`;
-                const filepath = join(process.cwd(), filename);
-                // Save screenshot to disk
-                await writeFile(filepath, screenshotBuffer);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Screenshot saved successfully to: ${filename}`,
-                        },
-                    ],
-                };
-            }
-            catch (err) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Failed to take screenshot. err: ${err.toString()}`,
-                        },
-                    ],
-                };
-            }
-        },
+        execute: async () => executeScreenshot(),
     });
 }
 //# sourceMappingURL=screenshot.js.map

package/dist/tools/interactions/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/tools/interactions/screenshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAe;IAChD,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,iEAAiE;QACnE,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;gBAEtD,2BAA2B;gBAC3B,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBAEjE,mCAAmC;gBACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,cAAc,SAAS,MAAM,CAAC;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAE/C,0BAA0B;gBAC1B,MAAM,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBAE5C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qCAAqC,QAAQ,EAAE;yBACtD;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mCAAmC,GAAG,CAAC,QAAQ,EAAE,EAAE;yBAC1D;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/tools/interactions/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAElD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAUD,MAAM,WAAW,GAAmB;IAClC,SAAS;IACT,SAAS;IACT,KAAK;IACL,oBAAoB;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;CAC1B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,WAAW;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAEtD,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEjE,mCAAmC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,cAAc,SAAS,MAAM,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAElD,yCAAyC;QACzC,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAErD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAE/C,0BAA0B;QAC1B,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEjD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qCAAqC,QAAQ,EAAE;iBACtD;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,mCAAmC,GAAG,CAAC,QAAQ,EAAE,EAAE;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAe;IAChD,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,iEAAiE;QACnE,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,IAAkB,EAAE,CAAC,iBAAiB,EAAE;KACvD,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appium-mcp",
   "mcpName": "io.github.appium/appium-mcp",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "type": "module",
   "repository": {
     "type": "git",

package/src/tests/screenshot.test.ts

@@ -0,0 +1,278 @@
+import {
+  describe,
+  test,
+  expect,
+  beforeEach,
+  afterEach,
+  jest,
+} from '@jest/globals';
+import { join, isAbsolute } from 'path';
+
+/**
+ * Local implementation of resolveScreenshotDir for testing.
+ * This mirrors the implementation in screenshot.ts to avoid importing
+ * the module which has heavy dependencies.
+ */
+function resolveScreenshotDir(): string {
+  const screenshotDir = process.env.SCREENSHOTS_DIR;
+
+  if (!screenshotDir) {
+    return process.cwd();
+  }
+
+  if (isAbsolute(screenshotDir)) {
+    return screenshotDir;
+  }
+
+  return join(process.cwd(), screenshotDir);
+}
+
+/**
+ * Interface for screenshot dependencies (mirrors screenshot.ts).
+ */
+interface ScreenshotDeps {
+  getDriver: () => { getScreenshot: () => Promise<string> } | null;
+  writeFile: (path: string, data: Buffer) => Promise<void>;
+  mkdir: (path: string, options: { recursive: boolean }) => Promise<void>;
+  resolveScreenshotDir: () => string;
+  dateNow: () => number;
+}
+
+/**
+ * Local implementation of executeScreenshot for testing.
+ * This mirrors the implementation in screenshot.ts.
+ */
+async function executeScreenshot(deps: ScreenshotDeps): Promise<any> {
+  const driver = deps.getDriver();
+  if (!driver) {
+    throw new Error('No driver found');
+  }
+
+  try {
+    const screenshotBase64 = await driver.getScreenshot();
+    const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
+    const timestamp = deps.dateNow();
+    const filename = `screenshot_${timestamp}.png`;
+    const screenshotDir = deps.resolveScreenshotDir();
+
+    await deps.mkdir(screenshotDir, { recursive: true });
+    const filepath = join(screenshotDir, filename);
+    await deps.writeFile(filepath, screenshotBuffer);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Screenshot saved successfully to: ${filename}`,
+        },
+      ],
+    };
+  } catch (err: any) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Failed to take screenshot. err: ${err.toString()}`,
+        },
+      ],
+    };
+  }
+}
+
+describe('resolveScreenshotDir', () => {
+  const originalEnv = process.env.SCREENSHOTS_DIR;
+  const cwd = process.cwd();
+
+  beforeEach(() => {
+    delete process.env.SCREENSHOTS_DIR;
+  });
+
+  afterEach(() => {
+    if (originalEnv !== undefined) {
+      process.env.SCREENSHOTS_DIR = originalEnv;
+    } else {
+      delete process.env.SCREENSHOTS_DIR;
+    }
+  });
+
+  test('should return process.cwd() when SCREENSHOTS_DIR is not set', () => {
+    const result = resolveScreenshotDir();
+    expect(result).toBe(cwd);
+  });
+
+  test('should return process.cwd() when SCREENSHOTS_DIR is empty string', () => {
+    process.env.SCREENSHOTS_DIR = '';
+    const result = resolveScreenshotDir();
+    expect(result).toBe(cwd);
+  });
+
+  test('should return absolute path as-is when SCREENSHOTS_DIR is absolute', () => {
+    const absolutePath = '/tmp/screenshots';
+    process.env.SCREENSHOTS_DIR = absolutePath;
+    const result = resolveScreenshotDir();
+    expect(result).toBe(absolutePath);
+  });
+
+  test('should join relative path with process.cwd()', () => {
+    const relativePath = 'screenshots';
+    process.env.SCREENSHOTS_DIR = relativePath;
+    const result = resolveScreenshotDir();
+    expect(result).toBe(join(cwd, relativePath));
+  });
+
+  test('should handle nested relative paths', () => {
+    const relativePath = 'output/screenshots/test';
+    process.env.SCREENSHOTS_DIR = relativePath;
+    const result = resolveScreenshotDir();
+    expect(result).toBe(join(cwd, relativePath));
+  });
+
+  test('should handle relative path starting with ./', () => {
+    const relativePath = './screenshots';
+    process.env.SCREENSHOTS_DIR = relativePath;
+    const result = resolveScreenshotDir();
+    expect(result).toBe(join(cwd, relativePath));
+  });
+
+  test('should handle relative path with parent directory reference', () => {
+    const relativePath = '../screenshots';
+    process.env.SCREENSHOTS_DIR = relativePath;
+    const result = resolveScreenshotDir();
+    expect(result).toBe(join(cwd, relativePath));
+  });
+});
+
+describe('executeScreenshot', () => {
+  const mockBase64 = 'dGVzdA=='; // 'test' in base64
+  const mockTimestamp = 1234567890;
+
+  function createMockDeps(
+    overrides: Partial<ScreenshotDeps> = {}
+  ): ScreenshotDeps {
+    return {
+      getDriver: jest.fn(() => ({
+        getScreenshot: jest.fn(() => Promise.resolve(mockBase64)),
+      })) as any,
+      writeFile: jest.fn(() => Promise.resolve()) as any,
+      mkdir: jest.fn(() => Promise.resolve()) as any,
+      resolveScreenshotDir: jest.fn(() => '/mock/screenshots') as any,
+      dateNow: jest.fn(() => mockTimestamp) as any,
+      ...overrides,
+    };
+  }
+
+  test('should throw error when no driver found', async () => {
+    const deps = createMockDeps({
+      getDriver: jest.fn(() => null) as any,
+    });
+
+    await expect(executeScreenshot(deps)).rejects.toThrow('No driver found');
+  });
+
+  test('should return success content with filename', async () => {
+    const deps = createMockDeps();
+
+    const result = await executeScreenshot(deps);
+
+    expect(result).toEqual({
+      content: [
+        {
+          type: 'text',
+          text: `Screenshot saved successfully to: screenshot_${mockTimestamp}.png`,
+        },
+      ],
+    });
+  });
+
+  test('should use resolved screenshot directory from SCREENSHOTS_DIR', async () => {
+    const customDir = '/custom/path/screenshots';
+    const deps = createMockDeps({
+      resolveScreenshotDir: jest.fn(() => customDir) as any,
+    });
+
+    await executeScreenshot(deps);
+
+    expect(deps.mkdir).toHaveBeenCalledWith(customDir, { recursive: true });
+    expect(deps.writeFile).toHaveBeenCalledWith(
+      join(customDir, `screenshot_${mockTimestamp}.png`),
+      expect.any(Buffer)
+    );
+  });
+
+  test('should create directory with recursive option', async () => {
+    const deps = createMockDeps();
+
+    await executeScreenshot(deps);
+
+    expect(deps.mkdir).toHaveBeenCalledWith('/mock/screenshots', {
+      recursive: true,
+    });
+  });
+
+  test('should write screenshot buffer to correct filepath', async () => {
+    const deps = createMockDeps();
+
+    await executeScreenshot(deps);
+
+    expect(deps.writeFile).toHaveBeenCalledWith(
+      `/mock/screenshots/screenshot_${mockTimestamp}.png`,
+      Buffer.from(mockBase64, 'base64')
+    );
+  });
+
+  test('should return error content when screenshot fails', async () => {
+    const errorMessage = 'Screenshot capture failed';
+    const deps = createMockDeps({
+      getDriver: jest.fn(() => ({
+        getScreenshot: jest.fn(() => Promise.reject(new Error(errorMessage))),
+      })) as any,
+    });
+
+    const result = await executeScreenshot(deps);
+
+    expect(result).toEqual({
+      content: [
+        {
+          type: 'text',
+          text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+        },
+      ],
+    });
+  });
+
+  test('should return error content when mkdir fails', async () => {
+    const errorMessage = 'Permission denied';
+    const deps = createMockDeps({
+      mkdir: jest.fn(() => Promise.reject(new Error(errorMessage))) as any,
+    });
+
+    const result = await executeScreenshot(deps);
+
+    expect(result).toEqual({
+      content: [
+        {
+          type: 'text',
+          text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+        },
+      ],
+    });
+  });
+
+  test('should return error content when writeFile fails', async () => {
+    const errorMessage = 'Disk full';
+    const deps = createMockDeps({
+      writeFile: jest.fn(() => Promise.reject(new Error(errorMessage))) as any,
+    });
+
+    const result = await executeScreenshot(deps);
+
+    expect(result).toEqual({
+      content: [
+        {
+          type: 'text',
+          text: `Failed to take screenshot. err: Error: ${errorMessage}`,
+        },
+      ],
+    });
+  });
+});

package/src/tools/README.md

@@ -29,6 +29,7 @@ This directory contains all MCP tools available in MCP Appium.
 - `click.ts` - Click elements
 - `double-tap.ts` - Double tap elements
 - `long-press.ts` - Long press (press and hold) elements
+- `drag-and-drop.ts` - Drag and drop elements or coordinates
 - `set-value.ts` - Enter text
 - `get-text.ts` - Get element text
 - `get-page-source.ts` - Get page source (XML) from current screen

package/src/tools/index.ts

@@ -31,6 +31,7 @@ import findElement from './interactions/find.js';
 import clickElement from './interactions/click.js';
 import doubleTap from './interactions/double-tap.js';
 import longPress from './interactions/long-press.js';
+import dragAndDrop from './interactions/drag-and-drop.js';
 import setValue from './interactions/set-value.js';
 import getText from './interactions/get-text.js';
 import getPageSource from './interactions/get-page-source.js';
@@ -131,6 +132,7 @@ export default function registerTools(server: FastMCP): void {
   clickElement(server);
   doubleTap(server);
   longPress(server);
+  dragAndDrop(server);
   setValue(server);
   getText(server);
   getPageSource(server);

package/src/tools/interactions/drag-and-drop.ts

@@ -0,0 +1,229 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+import { z } from 'zod';
+import { getDriver, getPlatformName } from '../../session-store.js';
+import { elementUUIDScheme } from '../../schema.js';
+
+const DROP_PAUSE_DURATION_MS = 150;
+
+async function performDragAndDrop(
+  driver: any,
+  startX: number,
+  startY: number,
+  endX: number,
+  endY: number,
+  duration: number,
+  longPressDuration: number
+): Promise<void> {
+  await driver.performActions([
+    {
+      type: 'pointer',
+      id: 'finger1',
+      parameters: { pointerType: 'touch' },
+      actions: [
+        { type: 'pointerMove', duration: 0, x: startX, y: startY },
+        { type: 'pointerDown', button: 0 },
+        { type: 'pause', duration: longPressDuration },
+        { type: 'pointerMove', duration: duration, x: endX, y: endY },
+        { type: 'pause', duration: DROP_PAUSE_DURATION_MS },
+        { type: 'pointerUp', button: 0 },
+      ],
+    },
+  ]);
+}
+
+export default function dragAndDrop(server: FastMCP): void {
+  const dragAndDropSchema = z.object({
+    sourceElementUUID: elementUUIDScheme
+      .trim()
+      .min(1)
+      .optional()
+      .describe(
+        'UUID of the source element to drag from. Either sourceElementUUID or sourceX/sourceY must be provided.'
+      ),
+    sourceX: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe(
+        'Starting X coordinate. Required if sourceElementUUID is not provided.'
+      ),
+    sourceY: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe(
+        'Starting Y coordinate. Required if sourceElementUUID is not provided.'
+      ),
+    targetElementUUID: elementUUIDScheme
+      .trim()
+      .min(1)
+      .optional()
+      .describe(
+        'UUID of the target element to drop on. Either targetElementUUID or targetX/targetY must be provided.'
+      ),
+    targetX: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe(
+        'Ending X coordinate. Required if targetElementUUID is not provided.'
+      ),
+    targetY: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe(
+        'Ending Y coordinate. Required if targetElementUUID is not provided.'
+      ),
+    duration: z
+      .number()
+      .int()
+      .min(100)
+      .max(5000)
+      .default(1200)
+      .optional()
+      .describe(
+        'Duration of the drag movement in milliseconds. Default is 1200ms.'
+      ),
+    longPressDuration: z
+      .number()
+      .int()
+      .min(400)
+      .max(2000)
+      .default(600)
+      .optional()
+      .describe(
+        'Duration of the long press before dragging in milliseconds. Default is 600ms.'
+      ),
+  });
+
+  server.addTool({
+    name: 'appium_drag_and_drop',
+    description: `Perform a drag and drop gesture from a source location to a target location.
+      The gesture includes:
+      1. Long press (default 600ms, configurable) on the source to initiate drag mode
+      2. While holding, drag to the target location
+      3. Release at the target to complete the drop
+      
+      Supports four modes:
+      1. Element to Element: Drag from one element to another element
+      2. Element to Coordinates: Drag from an element to specific coordinates
+      3. Coordinates to Element: Drag from coordinates to an element
+      4. Coordinates to Coordinates: Drag from coordinates to coordinates
+      
+      This is useful for reordering lists, moving items, drag-to-delete, and other drag interactions.`,
+    parameters: dragAndDropSchema,
+    annotations: {
+      readOnlyHint: false,
+      openWorldHint: false,
+    },
+    execute: async (args: any, context: any): Promise<any> => {
+      const driver = getDriver();
+      if (!driver) {
+        throw new Error('No driver found');
+      }
+
+      try {
+        const platform = getPlatformName(driver);
+        const duration = args.duration || 1200;
+        const longPressDuration = args.longPressDuration || 600;
+
+        if (
+          !args.sourceElementUUID &&
+          (args.sourceX === undefined || args.sourceY === undefined)
+        ) {
+          throw new Error(
+            'Either sourceElementUUID or both sourceX and sourceY must be provided.'
+          );
+        }
+
+        if (
+          !args.targetElementUUID &&
+          (args.targetX === undefined || args.targetY === undefined)
+        ) {
+          throw new Error(
+            'Either targetElementUUID or both targetX and targetY must be provided.'
+          );
+        }
+
+        let startX: number, startY: number;
+        let endX: number, endY: number;
+
+        if (args.sourceElementUUID) {
+          const rect = await driver.getElementRect(args.sourceElementUUID);
+          startX = Math.floor(rect.x + rect.width / 2);
+          startY = Math.floor(rect.y + rect.height / 2);
+        } else {
+          startX = args.sourceX;
+          startY = args.sourceY;
+        }
+
+        if (args.targetElementUUID) {
+          const rect = await driver.getElementRect(args.targetElementUUID);
+          endX = Math.floor(rect.x + rect.width / 2);
+          endY = Math.floor(rect.y + rect.height / 2);
+        } else {
+          endX = args.targetX;
+          endY = args.targetY;
+        }
+
+        const { width, height } = await driver.getWindowSize();
+        if (startX < 0 || startX >= width || startY < 0 || startY >= height) {
+          throw new Error(
+            `Source coordinates (${startX}, ${startY}) are out of screen bounds (${width}x${height})`
+          );
+        }
+        if (endX < 0 || endX >= width || endY < 0 || endY >= height) {
+          throw new Error(
+            `Target coordinates (${endX}, ${endY}) are out of screen bounds (${width}x${height})`
+          );
+        }
+
+        if (platform === 'Android' || platform === 'iOS') {
+          await performDragAndDrop(
+            driver,
+            startX,
+            startY,
+            endX,
+            endY,
+            duration,
+            longPressDuration
+          );
+        } else {
+          throw new Error(
+            `Unsupported platform: ${platform}. Only Android and iOS are supported.`
+          );
+        }
+
+        const sourceDesc = args.sourceElementUUID
+          ? `element ${args.sourceElementUUID}`
+          : `coordinates (${startX}, ${startY})`;
+        const targetDesc = args.targetElementUUID
+          ? `element ${args.targetElementUUID}`
+          : `coordinates (${endX}, ${endY})`;
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Successfully performed drag and drop from ${sourceDesc} to ${targetDesc}.`,
+            },
+          ],
+        };
+      } catch (err: any) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `Failed to perform drag and drop. Error: ${err.toString()}`,
+            },
+          ],
+        };
+      }
+    },
+  });
+}

package/src/tools/interactions/screenshot.ts

@@ -1,8 +1,90 @@
 import { FastMCP } from 'fastmcp/dist/FastMCP.js';
-import { z } from 'zod';
 import { getDriver } from '../../session-store.js';
-import { writeFile } from 'fs/promises';
-import { join } from 'path';
+import { writeFile, mkdir } from 'fs/promises';
+import { join, isAbsolute } from 'path';
+
+/**
+ * Resolves the screenshot directory path.
+ * - If SCREENSHOTS_DIR is not set, returns process.cwd()
+ * - If SCREENSHOTS_DIR is absolute, returns it as-is
+ * - If SCREENSHOTS_DIR is relative, joins it with process.cwd()
+ */
+export function resolveScreenshotDir(): string {
+  const screenshotDir = process.env.SCREENSHOTS_DIR;
+
+  if (!screenshotDir) {
+    return process.cwd();
+  }
+
+  if (isAbsolute(screenshotDir)) {
+    return screenshotDir;
+  }
+
+  return join(process.cwd(), screenshotDir);
+}
+
+export interface ScreenshotDeps {
+  getDriver: () => { getScreenshot: () => Promise<string> } | null;
+  writeFile: typeof writeFile;
+  mkdir: typeof mkdir;
+  resolveScreenshotDir: typeof resolveScreenshotDir;
+  dateNow: () => number;
+}
+
+const defaultDeps: ScreenshotDeps = {
+  getDriver,
+  writeFile,
+  mkdir,
+  resolveScreenshotDir,
+  dateNow: () => Date.now(),
+};
+
+export async function executeScreenshot(
+  deps: ScreenshotDeps = defaultDeps
+): Promise<any> {
+  const driver = deps.getDriver();
+  if (!driver) {
+    throw new Error('No driver found');
+  }
+
+  try {
+    const screenshotBase64 = await driver.getScreenshot();
+
+    // Convert base64 to buffer
+    const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
+
+    // Generate filename with timestamp
+    const timestamp = deps.dateNow();
+    const filename = `screenshot_${timestamp}.png`;
+    const screenshotDir = deps.resolveScreenshotDir();
+
+    // Create a directory if it doesn't exist
+    await deps.mkdir(screenshotDir, { recursive: true });
+
+    const filepath = join(screenshotDir, filename);
+
+    // Save screenshot to disk
+    await deps.writeFile(filepath, screenshotBuffer);
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Screenshot saved successfully to: ${filepath}`,
+        },
+      ],
+    };
+  } catch (err: any) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Failed to take screenshot. err: ${err.toString()}`,
+        },
+      ],
+    };
+  }
+}
 
 export default function screenshot(server: FastMCP): void {
   server.addTool({
@@ -13,44 +95,6 @@ export default function screenshot(server: FastMCP): void {
       readOnlyHint: false,
       openWorldHint: false,
     },
-    execute: async (args: any, context: any): Promise<any> => {
-      const driver = getDriver();
-      if (!driver) {
-        throw new Error('No driver found');
-      }
-
-      try {
-        const screenshotBase64 = await driver.getScreenshot();
-
-        // Convert base64 to buffer
-        const screenshotBuffer = Buffer.from(screenshotBase64, 'base64');
-
-        // Generate filename with timestamp
-        const timestamp = Date.now();
-        const filename = `screenshot_${timestamp}.png`;
-        const filepath = join(process.cwd(), filename);
-
-        // Save screenshot to disk
-        await writeFile(filepath, screenshotBuffer);
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `Screenshot saved successfully to: ${filename}`,
-            },
-          ],
-        };
-      } catch (err: any) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `Failed to take screenshot. err: ${err.toString()}`,
-            },
-          ],
-        };
-      }
-    },
+    execute: async (): Promise<any> => executeScreenshot(),
   });
 }