appium-mcp  by appium

Empowering AI assistants with intelligent mobile automation

Created 10 months ago
304 stars

Top 88.0% 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

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
49
Issues (30d)
8
Star History
70 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).

droidrun by droidrun

0.6%
8k
Framework for controlling Android devices via LLM agents
Created 1 year ago
Updated 4 days ago
Starred by Tobi Lutke Tobi Lutke(Cofounder of Shopify), Boris Cherny Boris Cherny(Creator of Claude Code; MTS at Anthropic), and
8 more.

screenpipe by screenpipe

0.7%
18k
AI app store for desktop history
Created 1 year ago
Updated 1 day ago
Feedback? Help us improve.