appium/appium-mcp

Developer tools 公式

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

512 stars 95 forks 品質 86 トレンド 42Apache-2.0

Repository Install

ステロイド投与中のアピウムMCPだ!

概要

MCP Appiumは、AIアシスタントにモバイル自動化のための強力なツール群を提供することを目的としたインテリジェントMCP(モデルコンテキストプロトコル)サーバーです。自然言語の操作、インテリジェントな位置検索生成、AndroidおよびiOSプラットフォームの自動テスト作成を可能にすることで、モバイルアプリのテストを効率化します。 - : Android(UiAutomator2)およびiOS(XCUITest)向けのテストを自動化。- : 視覚モデルに基づく自然言語記述を用いてUI要素を特定可能。複雑なXPathやセレクターは不要。- : 優先順位ベースの戦略を用いたAI搭載の要素識別。- : ローカルモバイルデバイス上でセッションを簡単に作成・管理。- : クリック、テキスト入力、スクリーンショット、要素発見などの操作を実行。- : 自然言語の記述からJava/TestNGテストコードを生成。- : 業界ベストプラクティスに従った組み込みテンプレートを活用。- : 異なる環境に応じた機能と設定をカスタマイズ。

概要（AI 翻訳）

🚀 特徴

クロスプラットフォームサポート:Android(UiAutomator2)とiOS(XCUITest)の両方でテストを自動化。
AI搭載の要素探索:視覚モデルを活用した自然言語の説明でUI要素を探し出せる。複雑なXPathやセレクターは不要。
インテリジェントロケーター生成:優先順位ベースの戦略を用いたAI搭載要素識別。
インタラクティブセッション管理:ローカルモバイルデバイス上でセッションを簡単に作成・管理できます。
スマート要素インタラクション:クリック、テキスト入力、スクリーンショット、要素検索などの操作を行います。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

MCP Appium - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices

MCP Appium is an intelligent MCP (Model Context Protocol) server designed to empower AI assistants with a robust suite of tools for mobile automation. It streamlines mobile app testing by enabling natural language interactions, intelligent locator generation, and automated test creation for both Android and iOS platforms.

Features
Prerequisites
Installation
Configuration
Remote server security and trust model
Available Tools
Plugin API
Client Support
Usage Examples
Contributing
License

🚀 Features

Cross-Platform Support: Automate tests for both Android (UiAutomator2) and iOS (XCUITest).
AI-Powered Element Finding: Locate UI elements using natural language descriptions powered by vision models - no need for complex XPath or selectors.
Intelligent Locator Generation: AI-powered element identification using priority-based strategies.
Interactive Session Management: Easily create and manage sessions on local mobile devices.
Smart Element Interactions: Perform actions like clicks, text input, screenshots, and element finding.
Automated Test Generation: Generate Java/TestNG test code from natural language descriptions.
Page Object Model Support: Utilize built-in templates that follow industry best practices.
Flexible Configuration: Customize capabilities and settings for different environments.
Multilingual Support: Use your native language - AI handles all interactions naturally in any language (English, Spanish, Chinese, Japanese, Korean, etc.).

📋 Prerequisites

Before you begin, ensure you have the following installed:

System Requirements

Node.js (v22 or higher)
npm or yarn
Java Development Kit (JDK) (8 or higher)
Android SDK (for Android testing)
Xcode (for iOS testing on macOS)

MCP Appium supports two driver modes:

Embedded local drivers: when appium_session_management creates an android or ios session without remoteServerUrl, MCP Appium uses the bundled appium-uiautomator2-driver or appium-xcuitest-driver dependency directly. You still need the platform toolchains below, but you do not need to install a global Appium server or run appium driver install uiautomator2 / appium driver install xcuitest for this mode.

GitHub で README 全文を見る

インストール

npx appium-mcp@latest

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "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"
      }
    }
  }
}