appium-mcp 0.0.1 → 1.1.5

package/dist/devicemanager/ios-manager.js

@@ -0,0 +1,122 @@
+import { Simctl } from 'node-simctl';
+import { utilities } from 'appium-ios-device';
+import log from '../locators/logger.js';
+/**
+ * iOS Device Manager to list and manage iOS devices and simulators
+ */
+export class IOSManager {
+    constructor() {
+        this.simctl = new Simctl();
+    }
+    /**
+     * Get the singleton instance of IOSManager
+     */
+    static getInstance() {
+        if (!IOSManager.instance) {
+            IOSManager.instance = new IOSManager();
+        }
+        return IOSManager.instance;
+    }
+    /**
+     * Check if running on macOS (required for iOS development)
+     */
+    isMac() {
+        return process.platform === 'darwin';
+    }
+    /**
+     * List all iOS simulators
+     * @returns Array of iOS simulators
+     */
+    async listSimulators() {
+        if (!this.isMac()) {
+            log.warn('iOS simulators are only available on macOS');
+            return [];
+        }
+        try {
+            const devices = await this.simctl.getDevices();
+            const simulators = [];
+            // devices is an object with runtime as key (e.g., "18.2") and array of devices as value
+            // node-simctl returns simplified runtime keys that are already iOS versions
+            for (const [runtime, deviceList] of Object.entries(devices)) {
+                if (Array.isArray(deviceList)) {
+                    for (const device of deviceList) {
+                        simulators.push({
+                            name: device.name,
+                            udid: device.udid,
+                            state: device.state,
+                            type: 'simulator',
+                            platform: runtime, // Runtime is already the iOS version (e.g., "18.2")
+                        });
+                    }
+                }
+            }
+            return simulators;
+        }
+        catch (error) {
+            log.error(`Error listing iOS simulators: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * List only booted (running) iOS simulators
+     * @returns Array of booted simulators
+     */
+    async listBootedSimulators() {
+        const allSimulators = await this.listSimulators();
+        return allSimulators.filter(simulator => simulator.state === 'Booted');
+    }
+    /**
+     * List all connected real iOS devices
+     * @returns Array of real iOS devices
+     */
+    async listRealDevices() {
+        if (!this.isMac()) {
+            log.warn('iOS real devices are only available on macOS');
+            return [];
+        }
+        try {
+            const devices = await utilities.getConnectedDevices();
+            return devices.map((udid) => ({
+                name: udid, // We'll use UDID as name for now
+                udid: udid,
+                type: 'real',
+            }));
+        }
+        catch (error) {
+            log.error(`Error listing iOS real devices: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Get all available iOS simulators
+     * @returns Array of all iOS simulators (both booted and shutdown)
+     */
+    async getAvailableSimulators() {
+        return await this.listSimulators();
+    }
+    /**
+     * Get all available real devices
+     * @returns Array of real iOS devices
+     */
+    async getAvailableRealDevices() {
+        return await this.listRealDevices();
+    }
+    /**
+     * Get devices based on device type
+     * @param deviceType 'simulator' or 'real'
+     * @returns Array of iOS devices
+     */
+    async getDevicesByType(deviceType) {
+        if (deviceType === 'simulator') {
+            return await this.getAvailableSimulators();
+        }
+        else {
+            return await this.getAvailableRealDevices();
+        }
+    }
+}
+/**
+ * Global iOS Manager instance
+ */
+export const iosManager = IOSManager.getInstance();
+//# sourceMappingURL=ios-manager.js.map

package/dist/devicemanager/ios-manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import server from './server.js';
+import log from './locators/logger.js';
+// Parse command line arguments
+const args = process.argv.slice(2);
+const useSSE = args.includes('--sse');
+const port = args.find(arg => arg.startsWith('--port='))?.split('=')[1] || '8080';
+// Start the server with the appropriate transport
+async function startServer() {
+    log.info('Starting MCP Appium MCP Server...');
+    try {
+        if (useSSE) {
+            // Start with SSE transport
+            server.start({
+                transportType: 'sse',
+                sse: {
+                    endpoint: '/sse',
+                    port: parseInt(port, 10),
+                },
+            });
+            log.info(`Server started with SSE transport on http://localhost:${port}/sse`);
+            log.info('Waiting for client connections...');
+        }
+        else {
+            // Start with stdio transport
+            server.start({
+                transportType: 'stdio',
+            });
+            log.info('Server started with stdio transport');
+            log.info('Waiting for client connections...');
+        }
+    }
+    catch (error) {
+        log.error('Error starting server:', error);
+        process.exit(1);
+    }
+}
+// Start the server
+startServer();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,sBAAsB,CAAC;AAEvC,+BAA+B;AAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACtC,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;AAEvE,kDAAkD;AAClD,KAAK,UAAU,WAAW;IACxB,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,2BAA2B;YAC3B,MAAM,CAAC,KAAK,CAAC;gBACX,aAAa,EAAE,KAAK;gBACpB,GAAG,EAAE;oBACH,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;iBACzB;aACF,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CACN,yDAAyD,IAAI,MAAM,CACpE,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,MAAM,CAAC,KAAK,CAAC;gBACX,aAAa,EAAE,OAAO;aACvB,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,WAAW,EAAE,CAAC"}

package/dist/locators/element-filter.d.ts

@@ -0,0 +1,13 @@
+import { JSONElement } from './source-parsing.js';
+export interface FilterOptions {
+    includeTagNames?: string[];
+    excludeTagNames?: string[];
+    requireAttributes?: string[];
+    minAttributeCount?: number;
+    fetchableOnly?: boolean;
+    clickableOnly?: boolean;
+}
+/**
+ * Determines if an element should be included based on all filter criteria
+ */
+export declare function shouldIncludeElement(element: JSONElement, filters: FilterOptions, isNative: boolean, automationName: string): boolean;

package/dist/locators/element-filter.js

@@ -0,0 +1,79 @@
+/**
+ * Determines if an element matches the tag name filters
+ */
+function matchesTagFilters(element, includeTagNames, excludeTagNames) {
+    if (includeTagNames.length > 0 &&
+        !includeTagNames.includes(element.tagName)) {
+        return false;
+    }
+    if (excludeTagNames.includes(element.tagName)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Determines if an element matches attribute-based filters
+ */
+function matchesAttributeFilters(element, requireAttributes, minAttributeCount) {
+    if (requireAttributes.length > 0) {
+        const hasRequiredAttr = requireAttributes.some(attr => element.attributes && element.attributes[attr]);
+        if (!hasRequiredAttr)
+            return false;
+    }
+    if (element.attributes &&
+        Object.keys(element.attributes).length < minAttributeCount) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Determines if an element is interactable/fetchable based on platform
+ */
+function isInteractableElement(element, isNative, automationName) {
+    const interactableTags = isNative && automationName === 'uiautomator2'
+        ? [
+            'EditText',
+            'Button',
+            'ImageButton',
+            'CheckBox',
+            'RadioButton',
+            'Switch',
+            'ToggleButton',
+            'TextView',
+        ]
+        : [
+            'XCUIElementTypeTextField',
+            'XCUIElementTypeSecureTextField',
+            'XCUIElementTypeButton',
+            'XCUIElementTypeImage',
+            'XCUIElementTypeSwitch',
+            'XCUIElementTypeStaticText',
+            'XCUIElementTypeTextView',
+            'XCUIElementTypeCell',
+            'XCUIElementTypeLink',
+        ];
+    return (interactableTags.some(tag => element.tagName.includes(tag)) ||
+        element.attributes?.clickable === 'true' ||
+        element.attributes?.focusable === 'true');
+}
+/**
+ * Determines if an element should be included based on all filter criteria
+ */
+export function shouldIncludeElement(element, filters, isNative, automationName) {
+    const { includeTagNames = [], excludeTagNames = ['hierarchy'], requireAttributes = [], minAttributeCount = 0, fetchableOnly = false, clickableOnly = false, } = filters;
+    if (!matchesTagFilters(element, includeTagNames, excludeTagNames)) {
+        return false;
+    }
+    if (!matchesAttributeFilters(element, requireAttributes, minAttributeCount)) {
+        return false;
+    }
+    if (clickableOnly && element.attributes?.clickable !== 'true') {
+        return false;
+    }
+    if (fetchableOnly &&
+        !isInteractableElement(element, isNative, automationName)) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=element-filter.js.map

package/dist/locators/element-filter.js.map

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

package/dist/locators/generate-all-locators.d.ts

@@ -0,0 +1,21 @@
+import { FilterOptions } from './element-filter.js';
+export interface ElementWithLocators {
+    tagName: string;
+    locators: Record<string, string>;
+    text: string;
+    contentDesc: string;
+    resourceId: string;
+    clickable: boolean;
+    enabled: boolean;
+    displayed: boolean;
+}
+/**
+ * Main function to generate locators for all elements from sourceXML
+ *
+ * @param sourceXML - The XML page source to process
+ * @param isNative - Whether this is a native context
+ * @param automationName - The automation driver name (uiautomator2, xcuitest, etc.)
+ * @param filters - Optional filters to apply when selecting elements
+ * @returns Array of elements with their generated locators
+ */
+export declare function generateAllElementLocators(sourceXML: string, isNative: boolean | undefined, automationName: string, filters?: FilterOptions): ElementWithLocators[];

package/dist/locators/generate-all-locators.js

@@ -0,0 +1,72 @@
+// Standalone Node.js script to generate locators for all elements from sourceXML
+// Using existing functions from src/locators directory
+import { getSuggestedLocators } from './locator-generation.js';
+import { xmlToJSON } from './source-parsing.js';
+import { shouldIncludeElement } from './element-filter.js';
+/**
+ * Transforms a JSONElement with locators into ElementWithLocators format
+ */
+function transformElementWithLocators(element, locators) {
+    // Filter out any undefined or invalid entries before converting to object
+    const validLocators = locators.filter((locator) => Array.isArray(locator) &&
+        locator.length === 2 &&
+        typeof locator[0] === 'string' &&
+        typeof locator[1] === 'string');
+    return {
+        tagName: element.tagName,
+        locators: Object.fromEntries(validLocators),
+        text: element.attributes.text || '',
+        contentDesc: element.attributes['content-desc'] || '',
+        resourceId: element.attributes['resource-id'] || '',
+        clickable: element.attributes.clickable === 'true',
+        enabled: element.attributes.enabled === 'true',
+        displayed: element.attributes.displayed === 'true',
+    };
+}
+/**
+ * Processes a single element: generates locators if it passes filters
+ */
+function processElement(element, sourceXML, isNative, automationName, filters, results) {
+    if (!shouldIncludeElement(element, filters, isNative, automationName)) {
+        return;
+    }
+    try {
+        const strategyMap = getSuggestedLocators(element, sourceXML, isNative, automationName);
+        results.push(transformElementWithLocators(element, strategyMap));
+    }
+    catch (error) {
+        console.error(`Error generating locators for element at path ${element.path}:`, error);
+    }
+}
+/**
+ * Recursively traverses the element tree and processes each element
+ */
+function traverseAndProcessElements(element, sourceXML, isNative, automationName, filters, results) {
+    if (!element) {
+        return;
+    }
+    // Process current element
+    processElement(element, sourceXML, isNative, automationName, filters, results);
+    // Recursively process children (even if parent was filtered out)
+    if (element.children && element.children.length > 0) {
+        element.children.forEach(child => traverseAndProcessElements(child, sourceXML, isNative, automationName, filters, results));
+    }
+}
+/**
+ * Main function to generate locators for all elements from sourceXML
+ *
+ * @param sourceXML - The XML page source to process
+ * @param isNative - Whether this is a native context
+ * @param automationName - The automation driver name (uiautomator2, xcuitest, etc.)
+ * @param filters - Optional filters to apply when selecting elements
+ * @returns Array of elements with their generated locators
+ */
+export function generateAllElementLocators(sourceXML, isNative = true, automationName, filters = {}) {
+    const sourceJSON = xmlToJSON(sourceXML);
+    const results = [];
+    if (sourceJSON) {
+        traverseAndProcessElements(sourceJSON, sourceXML, isNative, automationName, filters, results);
+    }
+    return results;
+}
+//# sourceMappingURL=generate-all-locators.js.map

package/dist/locators/generate-all-locators.js.map

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

package/dist/locators/locator-generation.d.ts

@@ -0,0 +1,36 @@
+import { JSONElement, ElementAttributes } from './source-parsing.js';
+import { Document as XMLDocument, Node as XMLNode } from '@xmldom/xmldom';
+/**
+ * Check whether the provided attribute & value are unique in the source
+ */
+export declare function areAttrAndValueUnique(attrName: string, attrValue: string, sourceDoc: XMLDocument): boolean;
+/**
+ * Get suggested selectors for simple locator strategies (which match a specific attribute)
+ */
+export declare function getSimpleSuggestedLocators(attributes: ElementAttributes, sourceDoc: XMLDocument, isNative?: boolean): Record<string, string>;
+/**
+ * Get suggested selectors for complex locator strategies (multiple attributes, axes, etc.)
+ */
+export declare function getComplexSuggestedLocators(path: string, sourceDoc: XMLDocument, isNative: boolean, automationName: string): Record<string, string>;
+/**
+ * Get suggested selectors for all locator strategies
+ */
+export declare function getSuggestedLocators(selectedElement: JSONElement, sourceXML: string, isNative: boolean, automationName: string): [string, string][];
+/**
+ * Get an optimal XPath for a Node
+ */
+export declare function getOptimalXPath(doc: XMLDocument, domNode: XMLNode): string | null;
+/**
+ * Get an optimal class chain for a Node based on the getOptimalXPath method
+ */
+export declare function getOptimalClassChain(doc: XMLDocument, domNode: XMLNode): string | null;
+/**
+ * Get an optimal predicate string for a Node based on the getOptimalXPath method
+ * Only works for a single element - no parent/child scope
+ */
+export declare function getOptimalPredicateString(doc: XMLDocument, domNode: XMLNode): string | null;
+/**
+ * Get an optimal UiAutomator selector for a Node
+ * Only works for elements inside the last direct child of the hierarchy (xpath: /hierarchy/*[last()] )
+ */
+export declare function getOptimalUiAutomatorSelector(doc: XMLDocument, domNode: XMLNode, path: string): string | null;