appium-mcp 0.0.1 → 1.1.4

package/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: Code Quality and Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-format-and-test:
+    name: ESLint, Prettier, and Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install --no-package-lock --force
+
+      - name: List installed packages
+        run: npm list --depth=0
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Run Prettier check
+        run: npm run format:check
+
+      - name: Run Locator Tests
+        run: npm run test:locators

package/.github/workflows/pr-title.yml

@@ -0,0 +1,15 @@
+name: Conventional Commits
+on:
+  pull_request:
+
+
+jobs:
+  lint:
+    name: https://www.conventionalcommits.org
+    runs-on: ubuntu-latest
+    steps:
+      - uses: beemojs/conventional-pr-action@v3
+        with:
+          config-preset: angular
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN  }}

package/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          submodules: recursive
+      - name: Setup submodules sparse-checkout
+        run: |
+          chmod +x scripts/setup-submodules-sparse.sh
+          ./scripts/setup-submodules-sparse.sh
+      - uses: actions/setup-node@v3
+        with:
+          node-version: lts/*
+          check-latest: true
+      - run: npm install --no-package-lock --force
+        name: Install dependencies
+      - run: npm run build
+        name: Build
+      - run: npx semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        name: Release

package/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "src/resources/submodules/appium"]
+	path = src/resources/submodules/appium
+	url = https://github.com/appium/appium.git
+[submodule "src/resources/submodules/appium-uiautomator2-driver"]
+	path = src/resources/submodules/appium-uiautomator2-driver
+	url = https://github.com/appium/appium-uiautomator2-driver.git
+[submodule "src/resources/submodules/appium-xcuitest-driver"]
+	path = src/resources/submodules/appium-xcuitest-driver
+	url = https://github.com/appium/appium-xcuitest-driver.git

package/.prettierignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Logs
+*.log
+
+# Package files
+package-lock.json
+yarn.lock
+
+# Git
+.git/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Generated files
+*.d.ts
+
+# Documents
+src/tools/documentation/uploads/documents.json

package/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "avoid"
+}

package/.releaserc

@@ -0,0 +1,37 @@
+{
+  "plugins": [
+    ["@semantic-release/commit-analyzer", {
+      "preset": "angular",
+      "releaseRules": [
+        {"type": "chore", "release": "patch"}
+      ]
+    }],
+    ["@semantic-release/release-notes-generator", {
+      "preset": "conventionalcommits",
+      "presetConfig": {
+        "types": [
+          {"type": "feat", "section": "Features"},
+          {"type": "fix", "section": "Bug Fixes"},
+          {"type": "perf", "section": "Performance Improvements"},
+          {"type": "revert", "section": "Reverts"},
+          {"type": "chore", "section": "Miscellaneous Chores"},
+          {"type": "refactor", "section": "Code Refactoring"},
+          {"type": "docs", "section": "Documentation", "hidden": true},
+          {"type": "style", "section": "Styles", "hidden": true},
+          {"type": "test", "section": "Tests", "hidden": true},
+          {"type": "build", "section": "Build System", "hidden": true},
+          {"type": "ci", "section": "Continuous Integration", "hidden": true}
+        ]
+      }
+    }],
+    ["@semantic-release/changelog", {
+      "changelogFile": "CHANGELOG.md"
+    }],
+    "@semantic-release/npm",
+    ["@semantic-release/git", {
+      "assets": ["docs", "package.json", "CHANGELOG.md"],
+      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+    }],
+    "@semantic-release/github"
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+## [1.1.4](https://github.com/appium/mcp-appium/compare/v1.1.3...v1.1.4) (2025-11-08)
+
+### Miscellaneous Chores
+
+* rename the package name to not conflict with others ([#23](https://github.com/appium/mcp-appium/issues/23)) ([a50190d](https://github.com/appium/mcp-appium/commit/a50190d5678d1d8e876462eba32e6c862841d123))
+
+## [1.1.3](https://github.com/AppiumTestDistribution/mcp-appium/compare/v1.1.2...v1.1.3) (2025-11-04)
+
+### Bug Fixes
+
+* Refactor as per Mykola comments ([#21](https://github.com/AppiumTestDistribution/mcp-appium/issues/21)) ([56ff593](https://github.com/AppiumTestDistribution/mcp-appium/commit/56ff593651b66a2137cda0bc649ed763e9959df4))
+
+## [1.1.2](https://github.com/AppiumTestDistribution/mcp-appium/compare/v1.1.1...v1.1.2) (2025-10-28)
+
+### Bug Fixes
+
+* address mykola review comments ([#20](https://github.com/AppiumTestDistribution/mcp-appium/issues/20)) ([9855dfb](https://github.com/AppiumTestDistribution/mcp-appium/commit/9855dfb755df99ceaf46981a36e3a5194f8fbb57))
+
+## [1.1.1](https://github.com/AppiumTestDistribution/mcp-appium/compare/v1.1.0...v1.1.1) (2025-10-21)
+
+### Bug Fixes
+
+* Bump release fix ([#16](https://github.com/AppiumTestDistribution/mcp-appium/issues/16)) ([d690b8a](https://github.com/AppiumTestDistribution/mcp-appium/commit/d690b8ac67c85f39ebc41b846abd6430047eaf48))
+
+### Miscellaneous Chores
+
+* **release:** 1.0.0 [skip ci] ([4c8a185](https://github.com/AppiumTestDistribution/mcp-appium/commit/4c8a185aa716ddd476dd9d556d3d75da7f1197b7))
+
+## 1.0.0 (2025-10-20)
+
+### Features
+
+* add tools to interact with the app ([#1](https://github.com/AppiumTestDistribution/mcp-appium/issues/1)) ([82f46fb](https://github.com/AppiumTestDistribution/mcp-appium/commit/82f46fb810f72ae432ec3bc9a197543f6ae596ba))
+
+### Bug Fixes
+
+* pick platform first ([c3d3db3](https://github.com/AppiumTestDistribution/mcp-appium/commit/c3d3db3b017ddf10f3ed5b208e765a6c2bd12239))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AppiumTestDistribution
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# MCP Appium - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices
+
+MCP Appium is an intelligent MCP (Model Context Protocol) server designed to empower AI assistants with a robust suite of tools for mobile automation. It streamlines mobile app testing by enabling natural language interactions, intelligent locator generation, and automated test creation for both Android and iOS platforms.
+
+## Table of Contents
+
+- [Features](#-features)
+- [Prerequisites](#-prerequisites)
+- [Installation](#️-installation)
+- [Configuration](#️-configuration)
+- [Available Tools](#-available-tools)
+- [Client Support](#-client-support)
+- [Usage Examples](#-usage-examples)
+- [Contributing](#-contributing)
+- [License](#-license)
+
+## 🚀 Features
+
+- **Cross-Platform Support**: Automate tests for both Android (UiAutomator2) and iOS (XCUITest).
+- **Intelligent Locator Generation**: AI-powered element identification using priority-based strategies.
+- **Interactive Session Management**: Easily create and manage sessions on local mobile devices.
+- **Smart Element Interactions**: Perform actions like clicks, text input, screenshots, and element finding.
+- **Automated Test Generation**: Generate Java/TestNG test code from natural language descriptions.
+- **Page Object Model Support**: Utilize built-in templates that follow industry best practices.
+- **Flexible Configuration**: Customize capabilities and settings for different environments.
+
+## 📋 Prerequisites
+
+Before you begin, ensure you have the following installed:
+
+### System Requirements
+
+- **Node.js** (v22 or higher)
+- **npm** or **yarn**
+- **Java Development Kit (JDK)** (8 or higher)
+- **Android SDK** (for Android testing)
+- **Xcode** (for iOS testing on macOS)
+
+### Mobile Testing Setup
+
+#### Android
+
+1.  Install Android Studio and the Android SDK.
+2.  Set the `ANDROID_HOME` environment variable.
+3.  Add the Android SDK tools to your system's PATH.
+4.  Enable USB debugging on your Android device.
+5.  Install the Appium UiAutomator2 driver dependencies.
+
+#### iOS (macOS only)
+
+1.  Install Xcode from the App Store.
+2.  Install the Xcode Command Line Tools: `xcode-select --install`.
+3.  Install iOS simulators through Xcode.
+4.  For real device testing, configure your provisioning profiles.
+
+## 🛠️ Installation
+
+### As an MCP Server
+
+To integrate MCP Appium with your MCP client, add the following to your configuration:
+
+```json
+{
+  "mcpServers": {
+    "mcp-appium": {
+      "disabled": false,
+      "timeout": 100,
+      "type": "stdio",
+      "command": "npx",
+      "args": ["mcp-appium"],
+      "env": {
+        "ANDROID_HOME": "/path/to/android/sdk",
+        "CAPABILITIES_CONFIG": "/path/to/your/capabilities.json"
+      }
+    }
+  }
+}
+```
+
+## ⚙️ Configuration
+
+### Capabilities
+
+Create a `capabilities.json` file to define your device capabilities:
+
+```json
+{
+  "android": {
+    "appium:app": "/path/to/your/android/app.apk",
+    "appium:deviceName": "Android Device",
+    "appium:platformVersion": "11.0",
+    "appium:automationName": "UiAutomator2",
+    "appium:udid": "your-device-udid"
+  },
+  "ios": {
+    "appium:app": "/path/to/your/ios/app.ipa",
+    "appium:deviceName": "iPhone 15 Pro",
+    "appium:platformVersion": "17.0",
+    "appium:automationName": "XCUITest",
+    "appium:udid": "your-device-udid"
+  }
+}
+```
+
+Set the `CAPABILITIES_CONFIG` environment variable to point to your configuration file.
+
+## 🎯 Available Tools
+
+### Session Management
+
+- `select_platform`: Choose between "android" or "ios".
+- `create_session`: Create a new mobile automation session.
+- `appium_activate_app`: Activate a specified app.
+- `appium_terminate_app`: Terminate a specified app.
+
+### Element Interaction
+
+- `generate_locators`: Generate intelligent locators for all interactive elements on the current screen.
+- `appium_find_element`: Find a specific element using various locator strategies.
+- `appium_click`: Click on an element.
+- `appium_set_value`: Enter text into an input field.
+- `appium_get_text`: Retrieve the text content of an element.
+- `appium_screenshot`: Capture a screenshot of the current screen.
+- `appium_scroll`: Scroll the screen vertically.
+- `appium_scroll_to_element`: Scroll until a specific element is found.
+
+### Test Generation
+
+- `appium_generate_tests`: Generate automated test code from natural language scenarios.
+
+## 🤖 Client Support
+
+MCP Appium is designed to be compatible with any MCP-compliant client.
+
+## 📚 Usage Examples
+
+### Amazon Mobile App Checkout Flow
+
+Here's an example prompt to test the Amazon mobile app checkout process:
+
+```
+Open Amazon mobile app, search for "iPhone 15 Pro", select the first search result, add the item to cart, proceed to checkout, sign in with email "test@example.com" and password "testpassword123", select shipping address, choose payment method, review order details, and place the order. Use JAVA + TestNG for test generation.
+```
+
+This example demonstrates a complete e-commerce checkout flow that can be automated using MCP Appium's intelligent locator generation and test creation capabilities.
+
+## 🙌 Contributing
+
+Contributions are welcome! Please feel free to submit a pull request or open an issue to discuss any changes.
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

package/dist/devicemanager/adb-manager.d.ts

@@ -0,0 +1,71 @@
+import { ADB } from 'appium-adb';
+/**
+ * Singleton ADB Manager to prevent multiple ADB instances
+ * This ensures only one ADB instance per host machine
+ */
+export declare class ADBManager {
+    private static instance;
+    private adbInstance;
+    private isInitialized;
+    private initializationPromise;
+    private constructor();
+    /**
+     * Get the singleton instance of ADBManager
+     */
+    static getInstance(): ADBManager;
+    /**
+     * Initialize ADB instance with configuration
+     * @param options ADB configuration options
+     * @returns Promise<ADB> The initialized ADB instance
+     */
+    initialize(options?: {
+        adbExecTimeout?: number;
+        udid?: string;
+    }): Promise<ADB>;
+    /**
+     * Get the current ADB instance
+     * @returns ADB instance or null if not initialized
+     */
+    getADBInstance(): ADB | null;
+    /**
+     * Check if ADB is initialized
+     * @returns boolean indicating initialization status
+     */
+    isADBInitialized(): boolean;
+    /**
+     * Reset the ADB instance (for testing or cleanup)
+     */
+    reset(): Promise<void>;
+    /**
+     * Create ADB instance with proper error handling
+     * @param options ADB configuration options
+     * @returns Promise<ADB> The created ADB instance
+     */
+    private _createADBInstance;
+    /**
+     * Get ADB instance for specific device operations
+     * This method ensures we reuse the singleton instance
+     * @param udid Optional device UDID for device-specific operations
+     * @returns Promise<ADB> The ADB instance
+     */
+    getADBForDevice(udid?: string): Promise<ADB>;
+}
+/**
+ * Global ADB Manager instance
+ * Use this throughout the application to access ADB functionality
+ */
+export declare const adbManager: ADBManager;
+/**
+ * Convenience function to get ADB instance
+ * @param options ADB configuration options
+ * @returns Promise<ADB> The ADB instance
+ */
+export declare function getADBInstance(options?: {
+    adbExecTimeout?: number;
+    udid?: string;
+}): Promise<ADB>;
+/**
+ * Convenience function to get existing ADB instance (without initialization)
+ * @returns ADB instance or null if not initialized
+ */
+export declare function getExistingADBInstance(): ADB | null;

package/dist/devicemanager/adb-manager.js

@@ -0,0 +1,140 @@
+import { ADB } from 'appium-adb';
+import log from '../locators/logger.js';
+/**
+ * Singleton ADB Manager to prevent multiple ADB instances
+ * This ensures only one ADB instance per host machine
+ */
+export class ADBManager {
+    constructor() {
+        this.adbInstance = null;
+        this.isInitialized = false;
+        this.initializationPromise = null;
+    }
+    /**
+     * Get the singleton instance of ADBManager
+     */
+    static getInstance() {
+        if (!ADBManager.instance) {
+            ADBManager.instance = new ADBManager();
+        }
+        return ADBManager.instance;
+    }
+    /**
+     * Initialize ADB instance with configuration
+     * @param options ADB configuration options
+     * @returns Promise<ADB> The initialized ADB instance
+     */
+    async initialize(options = {}) {
+        // If already initialized, return existing instance
+        if (this.isInitialized && this.adbInstance) {
+            log.debug('ADB instance already initialized, returning existing instance');
+            return this.adbInstance;
+        }
+        // If initialization is in progress, wait for it
+        if (this.initializationPromise) {
+            log.debug('ADB initialization in progress, waiting for completion');
+            return await this.initializationPromise;
+        }
+        // Start initialization
+        this.initializationPromise = this._createADBInstance(options);
+        try {
+            this.adbInstance = await this.initializationPromise;
+            this.isInitialized = true;
+            log.info('ADB instance initialized successfully');
+            return this.adbInstance;
+        }
+        catch (error) {
+            log.error(`Failed to initialize ADB instance: ${error}`);
+            this.initializationPromise = null;
+            throw error;
+        }
+    }
+    /**
+     * Get the current ADB instance
+     * @returns ADB instance or null if not initialized
+     */
+    getADBInstance() {
+        return this.adbInstance;
+    }
+    /**
+     * Check if ADB is initialized
+     * @returns boolean indicating initialization status
+     */
+    isADBInitialized() {
+        return this.isInitialized && this.adbInstance !== null;
+    }
+    /**
+     * Reset the ADB instance (for testing or cleanup)
+     */
+    async reset() {
+        if (this.adbInstance) {
+            try {
+                // Cleanup any existing ADB instance
+                log.info('Resetting ADB instance');
+                this.adbInstance = null;
+                this.isInitialized = false;
+                this.initializationPromise = null;
+            }
+            catch (error) {
+                log.error(`Error resetting ADB instance: ${error}`);
+            }
+        }
+    }
+    /**
+     * Create ADB instance with proper error handling
+     * @param options ADB configuration options
+     * @returns Promise<ADB> The created ADB instance
+     */
+    async _createADBInstance(options = {}) {
+        const defaultOptions = {
+            adbExecTimeout: 60000,
+            ...options,
+        };
+        log.info(`Creating ADB instance with options: ${JSON.stringify(defaultOptions)}`);
+        try {
+            const adb = await ADB.createADB(defaultOptions);
+            log.info('ADB instance created successfully');
+            return adb;
+        }
+        catch (error) {
+            log.error(`Failed to create ADB instance: ${error}`);
+            throw new Error(`ADB initialization failed: ${error}`);
+        }
+    }
+    /**
+     * Get ADB instance for specific device operations
+     * This method ensures we reuse the singleton instance
+     * @param udid Optional device UDID for device-specific operations
+     * @returns Promise<ADB> The ADB instance
+     */
+    async getADBForDevice(udid) {
+        if (!this.isADBInitialized()) {
+            await this.initialize({ udid });
+        }
+        if (!this.adbInstance) {
+            throw new Error('ADB instance not available');
+        }
+        return this.adbInstance;
+    }
+}
+/**
+ * Global ADB Manager instance
+ * Use this throughout the application to access ADB functionality
+ */
+export const adbManager = ADBManager.getInstance();
+/**
+ * Convenience function to get ADB instance
+ * @param options ADB configuration options
+ * @returns Promise<ADB> The ADB instance
+ */
+export async function getADBInstance(options = {}) {
+    return await adbManager.getADBForDevice(options.udid);
+}
+/**
+ * Convenience function to get existing ADB instance (without initialization)
+ * @returns ADB instance or null if not initialized
+ */
+export function getExistingADBInstance() {
+    return adbManager.getADBInstance();
+}
+//# sourceMappingURL=adb-manager.js.map

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

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

package/dist/devicemanager/ios-manager.d.ts

@@ -0,0 +1,58 @@
+export interface IOSDevice {
+    name: string;
+    udid: string;
+    state?: string;
+    type: 'simulator' | 'real';
+    platform?: string;
+}
+/**
+ * iOS Device Manager to list and manage iOS devices and simulators
+ */
+export declare class IOSManager {
+    private static instance;
+    private simctl;
+    private constructor();
+    /**
+     * Get the singleton instance of IOSManager
+     */
+    static getInstance(): IOSManager;
+    /**
+     * Check if running on macOS (required for iOS development)
+     */
+    isMac(): boolean;
+    /**
+     * List all iOS simulators
+     * @returns Array of iOS simulators
+     */
+    listSimulators(): Promise<IOSDevice[]>;
+    /**
+     * List only booted (running) iOS simulators
+     * @returns Array of booted simulators
+     */
+    listBootedSimulators(): Promise<IOSDevice[]>;
+    /**
+     * List all connected real iOS devices
+     * @returns Array of real iOS devices
+     */
+    listRealDevices(): Promise<IOSDevice[]>;
+    /**
+     * Get all available iOS simulators
+     * @returns Array of all iOS simulators (both booted and shutdown)
+     */
+    getAvailableSimulators(): Promise<IOSDevice[]>;
+    /**
+     * Get all available real devices
+     * @returns Array of real iOS devices
+     */
+    getAvailableRealDevices(): Promise<IOSDevice[]>;
+    /**
+     * Get devices based on device type
+     * @param deviceType 'simulator' or 'real'
+     * @returns Array of iOS devices
+     */
+    getDevicesByType(deviceType: 'simulator' | 'real'): Promise<IOSDevice[]>;
+}
+/**
+ * Global iOS Manager instance
+ */
+export declare const iosManager: IOSManager;