appium-mcp

gavrix/appium-mcp

3.3

If you are the rightful owner of appium-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

An Appium MCP server that facilitates mobile automation for iOS simulators and potentially Android devices.

The @gavrix/appium-mcp is a Model-Context-Protocol server designed to bridge the gap between MCP clients and mobile applications through Appium. It provides a standardized interface for controlling and interacting with mobile devices, primarily focusing on iOS simulators with future plans to support Android devices. The server abstracts Appium's functionalities, making it easier for automation scripts or Large Language Models to perform mobile application testing and automation tasks. By running the server via `npx`, users can quickly set up an environment to listen for incoming connections from MCP clients, enabling seamless integration and interaction with mobile applications.

Features

  • Standardized control and interaction with mobile devices.
  • Primarily targets iOS simulators with plans for Android support.
  • Abstracts Appium functionalities for easier mobile automation.
  • Designed to be run via `npx` for ease of use.
  • Facilitates integration with MCP clients like automation scripts or LLMs.

Usages

npx usage

npx @gavrix/appium-mcp

mcp client configuration

{
  "command": "npx",
  "args": ["@gavrix/appium-mcp"],
  "env": {}
}

Tools

  1. start_session

    Starts an Appium session with an automatically detected booted iOS simulator.

  2. launch_app

    Launches an application on the active Appium session using its bundle ID.

  3. get_page_source

    Retrieves the XML source hierarchy of the current screen.

  4. find_element

    Finds a UI element on the current screen using a specified strategy and selector.

  5. tap_element

    Taps or clicks an element identified by its unique element ID.

  6. get_screenshot

    Captures a screenshot of the current screen.

  7. get_device_logs

    Retrieves console logs from the connected device/simulator.

  8. simulate_gesture

    Simulates a custom gesture on the device.

  9. end_session

    Ends the current Appium session.