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 的智能定位器生成和測試創建功能實現自動化。