appium-mcp - 支持iOS与Android的跨平台移动应用测试MCP服务器，功能强大！

探索

Appium MCP

MCP Appium是一个基于模型上下文协议的智能移动自动化服务器，为AI助手提供跨平台移动应用测试工具，支持iOS和Android平台，具备智能元素定位、会话管理和自动化测试生成等功能。

开发者工具操作系统自动化 #移动自动化 #测试工具 #智能定位 #跨平台 .TypeScript

评分 : 3分

下载量 : 7.0K

更新时间 : 2025-12-29

打开站点

什么是MCP Appium?

MCP Appium是一个智能的移动自动化测试助手，它允许您通过自然语言与AI助手交互来控制移动设备。无论是测试手机应用、执行自动化任务，还是生成测试代码，您都可以用简单的语言描述您的需求，MCP Appium会帮您完成所有技术细节。

如何使用MCP Appium?

您只需要在支持的AI工具（如Cursor IDE、Claude Code、Gemini CLI）中安装MCP Appium，然后就可以用自然语言描述您想要测试的移动应用场景。例如，您可以告诉AI助手：'打开亚马逊应用，搜索iPhone并添加到购物车'，MCP Appium会自动执行这些操作并生成测试报告。

适用场景

MCP Appium特别适合移动应用开发者、测试工程师和产品经理。您可以用它来：1) 自动化测试应用功能；2) 生成测试代码；3) 验证用户体验流程；4) 在不同设备上测试应用兼容性；5) 快速创建演示或教程。

主要功能

跨平台支持

同时支持Android和iOS设备，包括模拟器、仿真器和真实手机，让您可以在不同平台上进行一致的测试。

智能元素定位

AI自动识别应用界面元素，无需手动编写复杂的定位代码，大大简化了测试脚本的创建过程。

会话管理

轻松创建和管理测试会话，支持同时连接多个设备，灵活切换不同的测试环境。

元素交互

支持点击、输入、滑动、滚动等多种交互操作，模拟真实用户的使用行为。

测试代码生成

根据自然语言描述自动生成Java/TestNG测试代码，支持行业最佳实践的Page Object Model模式。

上下文管理

支持在原生应用和WebView之间切换，方便测试混合应用或应用内嵌的网页内容。

优势

无需编程知识：通过自然语言即可控制移动设备进行测试

智能自动化：AI自动处理复杂的定位和交互逻辑

节省时间：自动生成测试代码，减少手动编写工作量

跨平台兼容：一套工具支持Android和iOS两大平台

易于集成：与主流AI开发工具无缝集成

局限性

需要环境配置：需要预先安装Android SDK或Xcode等开发工具

依赖设备连接：需要正确连接设备或启动模拟器

学习曲线：虽然使用简单，但理解移动测试概念仍需要一定学习

性能依赖：测试执行速度受设备和网络条件影响

如何使用

环境准备

安装必要的开发工具：Node.js v22+、Android SDK（Android测试）、Xcode（iOS测试）、Java JDK。确保设备已启用开发者选项和USB调试。

安装MCP Appium

在您使用的AI工具中配置MCP Appium服务器。不同工具的配置方式略有不同，但基本都需要指定npx命令和Android SDK路径。

配置设备能力

创建capabilities.json文件，定义要测试的设备信息，如设备名称、平台版本、应用路径等。

开始测试

在AI助手中用自然语言描述测试场景，MCP Appium会自动执行操作并返回结果。

使用案例

电商应用购物流程测试

测试一个完整的电商购物流程，从搜索商品到完成支付

社交媒体应用功能验证

验证社交媒体应用的核心功能，如发布内容、点赞、评论等

银行应用安全测试

测试银行应用的登录安全性和交易流程

常见问题

MCP Appium需要编程知识吗？

支持哪些移动设备？

如何查看测试结果？

测试数据如何管理？

可以测试Web应用吗？

性能如何？

🚀 MCP Appium - 用于移动开发与自动化的 MCP 服务器 | 支持 iOS、安卓、模拟器、仿真器和真机

MCP Appium 是一款智能的 MCP（模型上下文协议）服务器，旨在为 AI 助手提供一套强大的移动自动化工具。它通过支持自然语言交互、智能定位器生成以及为安卓和 iOS 平台自动创建测试，简化了移动应用测试流程。

🚀 快速开始

MCP Appium 为移动自动化测试带来了诸多便利，你可以按照以下步骤快速开启使用之旅。请先确保满足先决条件，这是顺利使用的基础。接着，根据你的使用场景，选择合适的安装方式，如在 Cursor IDE、使用 Gemini CLI 或 Claude Code CLI 等。安装完成后，还需要进行配置，包括设置设备能力和截图保存位置等。最后，你可以参考使用示例，开展自动化测试工作。

✨ 主要特性

跨平台支持：可对安卓（UiAutomator2）和 iOS（XCUITest）平台进行自动化测试。
智能定位器生成：借助基于优先级的策略，利用 AI 实现元素识别。
交互式会话管理：轻松在本地移动设备上创建和管理会话。
智能元素交互：能够执行点击、文本输入、截图和查找元素等操作。
自动化测试生成：根据自然语言描述生成 Java/TestNG 测试代码。
支持页面对象模型：使用遵循行业最佳实践的内置模板。
灵活配置：可针对不同环境自定义功能和设置。

📦 安装指南

标准配置

标准配置适用于大多数工具：

{
  "mcpServers": {
    "appium-mcp": {
      "disabled": false,
      "timeout": 100,
      "type": "stdio",
      "command": "npx",
      "args": [
        "appium-mcp@latest"
      ],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk",
        "CAPABILITIES_CONFIG": "/path/to/your/capabilities.json"
      }
    }
  }
}

在 Cursor IDE 中安装

在 Cursor IDE 中安装 MCP Appium 最简单的方法是使用一键安装按钮：这将自动在你的 Cursor IDE 设置中配置 MCP 服务器。请确保在配置中更新 ANDROID_HOME 环境变量，使其与你的安卓 SDK 路径匹配。

或手动安装

前往 Cursor 设置 → MCP → 添加新的 MCP 服务器。为其命名，使用命令类型并输入命令 npx -y appium-mcp@latest。你还可以通过点击编辑来验证配置或添加命令参数。

以下是推荐的配置：

{
  "appium-mcp": {
    "disabled": false,
    "timeout": 100,
    "type": "stdio",
    "command": "npx",
    "args": ["appium-mcp@latest"],
    "env": {
      "ANDROID_HOME": "/Users/xyz/Library/Android/sdk"
    }
  }
}

注意：请确保更新 ANDROID_HOME 路径，使其与你的安卓 SDK 安装路径匹配。

使用 Gemini CLI 安装

使用 Gemini CLI 添加 MCP Appium 服务器：

gemini mcp add appium-mcp npx -y appium-mcp@latest

这将自动配置 MCP 服务器以供 Gemini 使用。请确保在配置中更新 ANDROID_HOME 环境变量，使其与你的安卓 SDK 路径匹配。

使用 Claude Code CLI 安装

使用 Claude Code CLI 添加 MCP Appium 服务器：

claude mcp add appium-mcp -- npx -y appium-mcp@latest

这将自动配置 MCP 服务器以供 Claude Code 使用。请确保在配置中更新 ANDROID_HOME 环境变量，使其与你的安卓 SDK 路径匹配。

⚙️ 配置

设备能力

创建一个 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"
  }
}

设置 CAPABILITIES_CONFIG 环境变量，使其指向你的配置文件。

截图设置

设置 SCREENSHOTS_DIR 环境变量来指定截图的保存位置。如果未设置，截图将保存到当前工作目录。支持绝对路径和相对路径（相对路径相对于当前工作目录解析）。如果目录不存在，将自动创建。

🎯 可用工具

MCP Appium 提供了一套全面的工具，分为以下几类：

平台与设备设置

工具	描述
`select_platform`	首次使用必需：询问用户选择安卓或 iOS 平台
`select_device`	当有多个设备可用时，选择特定的设备
`boot_simulator`	启动 iOS 模拟器并等待其就绪（仅适用于 iOS）
`setup_wda`	为 iOS 模拟器下载并设置预构建的 WebDriverAgent（仅适用于 iOS）
`install_wda`	在已启动的 iOS 模拟器上安装并启动 WebDriverAgent（仅适用于 iOS）

会话管理

工具	描述
`create_session`	为安卓或 iOS 创建新的移动自动化会话
`delete_session`	删除当前的移动会话并清理资源

上下文管理

工具	描述
`appium_get_contexts`	获取当前 Appium 会话中所有可用的上下文。返回上下文名称列表，包括 NATIVE_APP 和任何 Web 视图上下文（例如，WEBVIEW_ 或 WEBVIEW_）。
`appium_switch_context`	切换到 Appium 会话中的特定上下文。用于在原生应用上下文（NATIVE_APP）和 Web 视图上下文（WEBVIEW_ 或 WEBVIEW_）之间切换。请先使用 `appium_get_contexts` 查看可用上下文。

元素发现与交互

工具	描述
`appium_find_element`	使用各种定位策略（xpath、id、可访问性 id 等）查找特定元素
`appium_click`	点击元素
`appium_double_tap`	对元素执行双击操作
`appium_long_press`	对元素执行长按（按下并保持）手势
`appium_drag_and_drop`	执行从源位置到目标位置的拖放手势（支持元素到元素、元素到坐标、坐标到元素和坐标到坐标）
`appium_set_value`	在输入字段中输入文本
`appium_get_text`	获取元素的文本内容

屏幕与导航

工具	描述
`appium_screenshot`	对当前屏幕进行截图并保存为 PNG 格式
`appium_scroll`	垂直滚动屏幕（向上或向下）
`appium_scroll_to_element`	滚动屏幕直到特定元素可见
`appium_swipe`	按方向（左、右、上、下）或在自定义坐标之间滑动屏幕
`appium_get_page_source`	获取当前屏幕的页面源（XML）

应用管理

工具	描述
`appium_activate_app`	通过包 ID 激活（启动/置于前台）指定的应用
`appium_installApp`	从文件路径在设备上安装应用
`appium_uninstallApp`	通过包 ID 从设备上卸载应用
`appium_terminateApp`	终止（关闭）指定的应用
`appium_list_apps`	列出设备上所有已安装的应用（仅适用于安卓）

测试生成与文档查询

工具	描述
`generate_locators`	为当前屏幕上的所有交互式元素生成智能定位器
`appium_generate_tests`	根据自然语言场景生成自动化测试代码
`appium_documentation_query`	使用 RAG 查询 Appium 文档以获取帮助和指导

🤖 客户端支持

MCP Appium 设计为与任何符合 MCP 标准的客户端兼容。

💻 使用示例

亚马逊移动应用结账流程

以下是一个测试亚马逊移动应用结账流程的示例提示：

打开亚马逊移动应用，搜索“iPhone 15 Pro”，选择第一个搜索结果，将商品添加到购物车，进入结账流程，使用电子邮件“test@example.com”和密码“testpassword123”登录，选择送货地址，选择付款方式，查看订单详情，然后下单。使用 JAVA + TestNG 生成测试。

此示例展示了一个完整的电子商务结账流程，可使用 MCP Appium 的智能定位器生成和测试创建功能实现自动化。