appium-mcp 0.0.1 → 1.1.4

package/dist/tools/select-platform.js

@@ -0,0 +1,195 @@
+/**
+ * Tool to select mobile platform before creating a session
+ */
+import { ADBManager } from '../devicemanager/adb-manager.js';
+import { IOSManager } from '../devicemanager/ios-manager.js';
+import { z } from 'zod';
+import log from '../locators/logger.js';
+/**
+ * Get and validate Android devices
+ */
+async function getAndroidDevices() {
+    const adb = await ADBManager.getInstance().initialize();
+    const devices = await adb.getConnectedDevices();
+    if (devices.length === 0) {
+        throw new Error('No Android devices/emulators found');
+    }
+    return devices;
+}
+/**
+ * Format multiple Android devices response
+ */
+function formatMultipleAndroidDevicesResponse(devices) {
+    const deviceList = devices
+        .map((device, index) => `  ${index + 1}. ${device.udid}`)
+        .join('\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `✅ Android platform selected\n\n⚠️ Multiple Android devices/emulators found (${devices.length}):\n${deviceList}\n\n🚨 IMPORTANT: You MUST use the select_device tool next to ask the user which device they want to use.\n\nDO NOT proceed to create_session until the user has selected a specific device using the select_device tool.`,
+            },
+        ],
+    };
+}
+/**
+ * Format single Android device response
+ */
+function formatSingleAndroidDeviceResponse(deviceUdid) {
+    const platformInfo = `Android platform selected (Found device: ${deviceUdid})`;
+    const nextSteps = `Found 1 Android device: ${deviceUdid}\n\n` +
+        "You can now create an Android session using the create_session tool with platform='android'. Make sure you have:\n" +
+        '• Android SDK installed\n' +
+        '• Android device connected or emulator running\n' +
+        '• USB debugging enabled (for real devices)';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `✅ ${platformInfo}\n\n📋 Next Steps:\n${nextSteps}\n\n🚀 Ready to create a session? Use the create_session tool with platform='android'`,
+            },
+        ],
+    };
+}
+/**
+ * Validate macOS for iOS testing
+ */
+function validateMacOSForIOS() {
+    const iosManager = IOSManager.getInstance();
+    if (!iosManager.isMac()) {
+        throw new Error('iOS testing is only available on macOS');
+    }
+}
+/**
+ * Format iOS device type selection prompt
+ */
+function formatIOSDeviceTypePrompt() {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `✅ iOS platform selected\n\n📱 Please specify the device type:\n\n⚠️ IMPORTANT: You MUST call select_platform again with the iosDeviceType parameter.\n\nOptions:\n1. 'simulator' - Use iOS Simulator\n2. 'real' - Use real iOS device\n\n🚀 Call select_platform with:\n• platform='ios'\n• iosDeviceType='simulator' OR iosDeviceType='real'`,
+            },
+        ],
+    };
+}
+/**
+ * Get and validate iOS devices by type
+ */
+async function getIOSDevices(iosDeviceType) {
+    const iosManager = IOSManager.getInstance();
+    const devices = await iosManager.getDevicesByType(iosDeviceType);
+    if (devices.length === 0) {
+        const deviceTypeText = iosDeviceType === 'simulator' ? 'simulators' : 'real devices';
+        const helpText = iosDeviceType === 'simulator'
+            ? 'Please start an iOS simulator using Xcode or use "xcrun simctl boot <SIMULATOR_UDID>"'
+            : 'Please connect an iOS device via USB and ensure it is trusted';
+        throw new Error(`No iOS ${deviceTypeText} found. ${helpText}`);
+    }
+    return devices;
+}
+/**
+ * Format multiple iOS devices response
+ */
+function formatMultipleIOSDevicesResponse(devices, iosDeviceType) {
+    const deviceList = devices
+        .map((device, index) => `  ${index + 1}. ${device.name} (${device.udid})${device.state ? ` - ${device.state}` : ''}`)
+        .join('\n');
+    const deviceTypeText = iosDeviceType === 'simulator' ? 'simulators' : 'devices';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `✅ iOS platform selected (${iosDeviceType})\n\n⚠️ Multiple iOS ${deviceTypeText} found (${devices.length}):\n${deviceList}\n\n🚨 IMPORTANT: You MUST use the select_device tool next to ask the user which device they want to use.\n\nDO NOT proceed to create_session until the user has selected a specific device using the select_device tool.`,
+            },
+        ],
+    };
+}
+/**
+ * Format single iOS device response
+ */
+function formatSingleIOSDeviceResponse(device, iosDeviceType) {
+    const platformInfo = `iOS ${iosDeviceType} selected (Found device: ${device.name} - ${device.udid})`;
+    const nextSteps = `Found 1 iOS ${iosDeviceType}: ${device.name} (${device.udid})\n\n` +
+        "You can now create an iOS session using the create_session tool with platform='ios'. Make sure you have:\n" +
+        '• Xcode installed (macOS only)\n' +
+        (iosDeviceType === 'simulator'
+            ? '• iOS simulator running\n'
+            : '• iOS device connected via USB\n• Developer certificates configured\n• Device trusted on your Mac\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `✅ ${platformInfo}\n\n📋 Next Steps:\n${nextSteps}\n\n🚀 Ready to create a session? Use the create_session tool with platform='ios'`,
+            },
+        ],
+    };
+}
+/**
+ * Handle Android platform selection
+ */
+async function handleAndroidPlatformSelection() {
+    const devices = await getAndroidDevices();
+    if (devices.length > 1) {
+        return formatMultipleAndroidDevicesResponse(devices);
+    }
+    return formatSingleAndroidDeviceResponse(devices[0].udid);
+}
+/**
+ * Handle iOS platform selection
+ */
+async function handleIOSPlatformSelection(iosDeviceType) {
+    validateMacOSForIOS();
+    if (!iosDeviceType) {
+        return formatIOSDeviceTypePrompt();
+    }
+    const devices = await getIOSDevices(iosDeviceType);
+    if (devices.length > 1) {
+        return formatMultipleIOSDevicesResponse(devices, iosDeviceType);
+    }
+    return formatSingleIOSDeviceResponse(devices[0], iosDeviceType);
+}
+export default function selectPlatform(server) {
+    server.addTool({
+        name: 'select_platform',
+        description: `REQUIRED: First ASK THE USER which mobile platform they want to use (Android or iOS) before creating a session.
+      DO NOT assume or default to any platform.
+      You MUST explicitly prompt the user to choose between Android or iOS.
+      This is mandatory before proceeding to use the create_session tool.
+      `,
+        parameters: z.object({
+            platform: z
+                .enum(['ios', 'android'])
+                .describe("REQUIRED: The platform chosen by the user - 'android' for Android devices/emulators or 'ios' for iOS devices/simulators. This must be based on the user's explicit choice, NOT a default assumption."),
+            iosDeviceType: z
+                .enum(['simulator', 'real'])
+                .optional()
+                .describe("For iOS only: Specify whether to use 'simulator' or 'real' device. REQUIRED when platform is 'ios'."),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                const { platform, iosDeviceType } = args;
+                if (platform === 'android') {
+                    log.info('Platform selected: ANDROID');
+                    return await handleAndroidPlatformSelection();
+                }
+                else if (platform === 'ios') {
+                    log.info('Platform selected: IOS');
+                    return await handleIOSPlatformSelection(iosDeviceType);
+                }
+                else {
+                    throw new Error(`Invalid platform: ${platform}. Please choose 'android' or 'ios'.`);
+                }
+            }
+            catch (error) {
+                log.error(`[select_platform] ${error?.stack || error?.message || String(error)}`);
+                throw new Error(`Failed to select platform: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=select-platform.js.map

package/dist/tools/select-platform.js.map

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

package/dist/tools/session-store.d.ts

@@ -0,0 +1,7 @@
+export declare function setSession(d: any, id: string | null): void;
+export declare function getDriver(): any;
+export declare function getSessionId(): string | null;
+export declare function isDeletingSessionInProgress(): boolean;
+export declare function hasActiveSession(): boolean;
+export declare function safeDeleteSession(): Promise<boolean>;
+export declare const getPlatformName: (driver: any) => string;

package/dist/tools/session-store.js

@@ -0,0 +1,64 @@
+import { AndroidUiautomator2Driver } from 'appium-uiautomator2-driver';
+import { XCUITestDriver } from 'appium-xcuitest-driver';
+let driver = null;
+let sessionId = null;
+let isDeletingSession = false; // Lock to prevent concurrent deletion
+export function setSession(d, id) {
+    driver = d;
+    sessionId = id;
+    // Reset deletion flag when setting a new session
+    if (d && id) {
+        isDeletingSession = false;
+    }
+}
+export function getDriver() {
+    return driver;
+}
+export function getSessionId() {
+    return sessionId;
+}
+export function isDeletingSessionInProgress() {
+    return isDeletingSession;
+}
+export function hasActiveSession() {
+    return driver !== null && sessionId !== null && !isDeletingSession;
+}
+export async function safeDeleteSession() {
+    // Check if there's no session to delete
+    if (!driver || !sessionId) {
+        console.log('No active session to delete.');
+        return false;
+    }
+    // Check if deletion is already in progress
+    if (isDeletingSession) {
+        console.log('Session deletion already in progress, skipping...');
+        return false;
+    }
+    // Set lock
+    isDeletingSession = true;
+    try {
+        console.log('Deleting current session');
+        await driver.deleteSession();
+        // Clear the session from store
+        driver = null;
+        sessionId = null;
+        console.log('Session deleted successfully.');
+        return true;
+    }
+    catch (error) {
+        console.error('Error deleting session:', error);
+        throw error;
+    }
+    finally {
+        // Always release lock
+        isDeletingSession = false;
+    }
+}
+export const getPlatformName = (driver) => {
+    if (driver instanceof AndroidUiautomator2Driver)
+        return 'Android';
+    if (driver instanceof XCUITestDriver)
+        return 'iOS';
+    throw new Error('Unknown driver type');
+};
+//# sourceMappingURL=session-store.js.map

package/dist/tools/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/tools/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,IAAI,MAAM,GAAQ,IAAI,CAAC;AACvB,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,IAAI,iBAAiB,GAAG,KAAK,CAAC,CAAC,sCAAsC;AAErE,MAAM,UAAU,UAAU,CAAC,CAAM,EAAE,EAAiB;IAClD,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,EAAE,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACZ,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,wCAAwC;IACxC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;IACX,iBAAiB,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE7B,+BAA+B;QAC/B,MAAM,GAAG,IAAI,CAAC;QACd,SAAS,GAAG,IAAI,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,sBAAsB;QACtB,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAW,EAAU,EAAE;IACrD,IAAI,MAAM,YAAY,yBAAyB;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,MAAM,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist/tools/setup-wda.d.ts

@@ -0,0 +1 @@
+export default function setupWDA(server: any): void;

package/dist/tools/setup-wda.js

@@ -0,0 +1,177 @@
+/**
+ * Tool to download and setup WebDriverAgent (WDA) for iOS simulators
+ */
+import { z } from 'zod';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+import { access, mkdir, unlink } from 'fs/promises';
+import { constants } from 'fs';
+import { createWriteStream } from 'fs';
+import { pipeline } from 'stream/promises';
+import os from 'os';
+import axios from 'axios';
+import log from '../locators/logger.js';
+const execAsync = promisify(exec);
+function cachePath(folder) {
+    return path.join(os.homedir(), '.cache', 'appium-mcp', folder);
+}
+async function getLatestWDAVersion() {
+    try {
+        const response = await axios.get('https://api.github.com/repos/appium/WebDriverAgent/releases/latest', {
+            headers: {
+                'User-Agent': 'mcp-appium',
+                Accept: 'application/vnd.github.v3+json',
+            },
+        });
+        const release = response.data;
+        if (release.tag_name) {
+            return release.tag_name.replace(/^v/, '');
+        }
+        else {
+            throw new Error('No tag_name found in release data');
+        }
+    }
+    catch (error) {
+        if (error.response) {
+            throw new Error(`Failed to fetch WDA version: ${error.response.status} ${error.response.statusText}`);
+        }
+        throw error;
+    }
+}
+async function cleanupFile(path) {
+    try {
+        await access(path, constants.F_OK);
+        await unlink(path);
+    }
+    catch {
+        // File doesn't exist or already deleted
+    }
+}
+async function downloadFile(url, destPath) {
+    try {
+        const response = await axios({
+            url,
+            method: 'GET',
+            responseType: 'stream',
+            maxRedirects: 5,
+        });
+        const writer = createWriteStream(destPath);
+        try {
+            await pipeline(response.data, writer);
+        }
+        catch (streamError) {
+            writer.close();
+            await cleanupFile(destPath);
+            throw streamError;
+        }
+    }
+    catch (error) {
+        // Clean up partial file on error
+        await cleanupFile(destPath);
+        if (error.response) {
+            throw new Error(`Failed to download: ${error.response.status} ${error.response.statusText}`);
+        }
+        throw error;
+    }
+}
+async function unzipFile(zipPath, destDir) {
+    await execAsync(`unzip -q "${zipPath}" -d "${destDir}"`);
+}
+export default function setupWDA(server) {
+    server.addTool({
+        name: 'setup_wda',
+        description: `Download and setup prebuilt WebDriverAgent (WDA) for iOS/tvOS simulators only (not for real devices).
+      This significantly speeds up the first Appium session by avoiding the need to build WDA from source.
+      Downloads the latest version from GitHub and caches it locally.
+      `,
+        parameters: z.object({
+            platform: z
+                .enum(['ios', 'tvos'])
+                .optional()
+                .default('ios')
+                .describe(`The simulator platform to download WDA for.
+          Default is "ios".
+          Use "tvos" for Apple TV simulators.
+          Note: This tool only works with simulators, not real devices.`),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                const { platform = 'ios' } = args;
+                // Verify it's a macOS system
+                if (process.platform !== 'darwin') {
+                    throw new Error('WebDriverAgent setup is only supported on macOS systems');
+                }
+                // Get the architecture
+                const arch = os.arch();
+                const archStr = arch === 'arm64' ? 'arm64' : 'x86_64';
+                // Fetch latest WDA version from GitHub
+                const wdaVersion = await getLatestWDAVersion();
+                // Create cache directory structure
+                const versionCacheDir = cachePath(`wda/${wdaVersion}`);
+                const extractDir = path.join(versionCacheDir, 'extracted');
+                const zipPath = path.join(versionCacheDir, `WebDriverAgentRunner-Build-Sim-${archStr}.zip`);
+                const appPath = path.join(extractDir, 'WebDriverAgentRunner-Runner.app');
+                // Check if this version is already cached
+                try {
+                    await access(appPath, constants.F_OK);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `✅ WebDriverAgent is already set up!\n\nVersion: ${wdaVersion}\nPlatform: ${platform} (simulator only)\nArchitecture: ${archStr}\nLocation: ${appPath}\nCache: ~/.cache/appium-mcp/wda/${wdaVersion}\n\n🚀 You can now create an Appium session without needing to build WDA from source.`,
+                            },
+                        ],
+                    };
+                }
+                catch {
+                    // File doesn't exist, continue to download
+                }
+                // Version not cached, download it
+                const startTime = Date.now();
+                // Create cache directories
+                await mkdir(versionCacheDir, { recursive: true });
+                await mkdir(extractDir, { recursive: true });
+                // Download URL - use architecture-specific filename
+                const downloadUrl = `https://github.com/appium/WebDriverAgent/releases/download/v${wdaVersion}/WebDriverAgentRunner-Build-Sim-${archStr}.zip`;
+                log.info(`Downloading prebuilt WDA v${wdaVersion} for ${platform} simulator...`);
+                await downloadFile(downloadUrl, zipPath);
+                log.info('Extracting WebDriverAgent...');
+                await unzipFile(zipPath, extractDir);
+                const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+                // Verify extraction
+                try {
+                    await access(appPath, constants.F_OK);
+                }
+                catch {
+                    throw new Error('WebDriverAgent extraction failed - app bundle not found');
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${JSON.stringify({
+                                version: wdaVersion,
+                                platform: platform,
+                                architecture: archStr,
+                                wdaAppPath: appPath,
+                                wdaCachePath: `~/.cache/appium-mcp/wda/${wdaVersion}`,
+                                simulatorOnly: true,
+                                ready: true,
+                            }, null, 2)}`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                log.error('Error setting up WDA:', error);
+                throw new Error(`Failed to setup WebDriverAgent: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=setup-wda.js.map

package/dist/tools/setup-wda.js.map

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