appium-mcp  by appium

Empowering AI assistants with intelligent mobile automation

Created 11 months ago
369 stars

Top 76.4% on SourcePulse

GitHubView on GitHub
Project Summary

Appium MCP on Steroids provides an intelligent MCP (Model Context Protocol) server designed to integrate AI assistants with mobile automation tools for iOS and Android. It targets developers and testers seeking to streamline mobile app testing through natural language interactions, AI-driven element identification, and automated test generation, offering significant benefits in efficiency and cost reduction.

How It Works

This project functions as an MCP server that translates natural language commands, processed by AI assistants, into actionable Appium commands. Its core approach leverages AI for intelligent locator generation, enabling robust element identification across platforms. It supports cross-platform automation for Android (UiAutomator2) and iOS (XCUITest), with a notable NO_UI mode that optimizes performance and reduces LLM token costs by omitting UI rendering.

Quick Start & Requirements

  • Primary Install: npx appium-mcp@latest (via npm/yarn). Integrations available for Cursor IDE, Gemini CLI, and Claude Code CLI.
  • Prerequisites: Node.js (v22+), npm/yarn, JDK (8+), Android SDK (for Android), Xcode (for iOS on macOS). Requires setting ANDROID_HOME environment variable and configuring capabilities via capabilities.json.
  • Links: Installation instructions are detailed within the README for various IDEs and CLIs.

Highlighted Details

  • Cross-Platform Support: Automates tests for both Android (UiAutomator2) and iOS (XCUITest).
  • AI-Powered Locators: Employs AI for intelligent, priority-based element identification.
  • Multilingual Interaction: Understands and processes commands in multiple languages, including English, Spanish, Chinese, Japanese, and Korean.
  • NO_UI Mode: Offers substantial performance gains (50-80% faster responses), drastically reduces LLM token and bandwidth costs, and lowers memory usage by disabling UI rendering.

Maintenance & Community

No specific details regarding contributors, sponsorships, or community channels (e.g., Discord, Slack) are provided in the README.

Licensing & Compatibility

  • License: Apache-2.0.
  • Compatibility: The Apache-2.0 license is permissive, generally allowing for commercial use and integration within closed-source projects.

Limitations & Caveats

iOS automation requires a macOS environment due to Xcode dependencies. The NO_UI mode, while beneficial for performance and cost, is not suitable for interactive debugging or visual exploration.

Health Check
Last Commit

14 hours ago

Responsiveness

Inactive

Pull Requests (30d)
57
Issues (30d)
15
Star History
40 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems") and Gregor Zunic Gregor Zunic(Cofounder of Browser Use).

mobilerun by droidrun

0.6%
8k
Framework for controlling Android devices via LLM agents
Created 1 year ago
Updated 23 hours ago
Feedback? Help us improve.