一台Appium MCP（模型-上下文-协议）服务器，作为MCP客户端工具，展示了iOS模拟器和Android模拟器/设备的移动自动化功能。实现了与移动设备的标准化控制和交互。

该服务器作为桥接，使MCP客户端（如大型语言模型或自动化脚本）通过Appium与移动应用交互。

概述

该项目的主要目标是基于模型上下文协议提供一套可调用工具。这些工具抽象了 Appium 在移动应用测试和自动化方面的功能。

该服务器支持iOS模拟器和Android模拟器/设备，具备自动设备检测和平台特定优化功能。

该服务器设计为通过npx运行，便于使用。

安装

要将该服务器作为项目中的依赖使用（通常通过 npx 独立运行）：

或者，如果你用纱线：

用途

运行服务器最常见的方式是使用 npx：

这会启动MCP服务器，然后监听来自MCP客户端（例如通过stdio）的连接。

用于MCP客户端配置

@gavrix/appium-mcp

An Appium MCP (Model-Context-Protocol) server that exposes mobile automation capabilities for both iOS simulators and Android emulators/devices as tools for MCP clients. Enables standardized control and interaction with mobile devices.

This server acts as a bridge, allowing an MCP client (like a Large Language Model or an automation script) to interact with mobile applications through Appium.

Overview

The primary goal of this project is to provide a set of callable tools over the Model Context Protocol. These tools abstract Appium’s functionalities for mobile application testing and automation.

The server supports both iOS simulators and Android emulators/devices with automatic device detection and platform-specific optimizations.

The server is designed to be run via npx for ease of use.

Installation

To use this server as a dependency in your project (though typically it’s run standalone via npx):

npm install @gavrix/appium-mcp

Or, if you use Yarn:

yarn add @gavrix/appium-mcp

Usage

The most common way to run the server is using npx:

npx @gavrix/appium-mcp

This will start the MCP server, which will then listen for incoming connections from an MCP client (e.g., via stdio).

For MCP Client Configuration

If you are configuring an MCP client (like Cursor) to use this server, you would typically set the command as follows (assuming the package is installed globally or npx is used):

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

Available Tools

The server exposes the following tools to an MCP client:

Session Management

• start_session: Starts an Appium session with an automatically detected device (iOS simulator or Android emulator/device). Supports platform selection and device targeting.
  • Parameters: platform (optional): ‘ios’, ‘android’, or ‘auto’ (default)
  • Parameters: deviceName (optional): specific device name to target
• end_session: Ends the current Appium session and cleans up resources.

App Control

• launch_app: Launches an application using its identifier (bundle ID for iOS, package name for Android).

Element Interaction

• find_element: Finds a UI element on the current screen using a specified strategy and selector.
• tap_element: Taps or clicks an element identified by its unique element ID.
• enter_text: Enters text into a specific element, like an input field.
• get_element_text: Gets the text content from an element.

Screen Capture & Analysis

• get_page_source: Retrieves the XML source hierarchy of the current screen.
• get_page_source_file: Saves the page source XML to a specified file path.
• get_screenshot: Captures a screenshot and returns it as base64-encoded data.