appium/appium-mcp

Developer tools Официальный

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

512 stars 95 forks Качество 86 Тренд 41Apache-2.0

Repository Install

Аппиум MCP на стероидах!

Обзор

MCP Appium — это интеллектуальный сервер MCP (Model Context Protocol), разработанный для того, чтобы дать ассистентам ИИ полноценный набор инструментов для мобильной автоматизации. Он упрощает тестирование мобильных приложений, позволяя взаимодействие с естественным языком, генерировать интеллектуальные локаторы и автоматизировать создание тестов как для платформ Android, так и iOS. - : Автоматизировать тесты для Android (UiAutomator2) и iOS (XCUITest). - : Находить элементы интерфейса с помощью описаний на естественном языке, основанных на визуальных моделях — нет необходимости в сложных XPath или селекторах. - : Идентификация элементов на базе ИИ с использованием приоритетных стратегий. - : Простое создание и управление сессиями на локальных мобильных устройствах. - : Выполнение действий, таких как клики, ввод текста, скриншоты и поиск элементов. - : Генерация тестового кода Java/TestNG на основе описаний на естественном языке. - : Использование встроенных шаблонов, соответствующих лучшим отраслевым практикам. - : Настройка возможностей и настроек для различных сред.

Обзор (машинный перевод)

Содержание

Особенности
Предварительные требования
Установка
Конфигурация
Модель безопасности и доверия удалённых серверов
Доступные инструменты
API плагинов
Клиентская поддержка
Примеры использования
Вклад
Лицензия

🚀 Особенности

Кроссплатформенная поддержка: Автоматизировать тестирование как для Android (UiAutomator2), так и для iOS (XCUITest).
Поиск элементов на базе искусственного интеллекта: Поиск элементов интерфейса с помощью описаний на естественном языке, основанных на моделях зрения — не требуется сложный XPath или селекторы.
Генерация интеллектуального поиска: идентификация элементов с помощью ИИ с использованием приоритетных стратегий.
Интерактивное управление сессиями: Легко создавать и управлять сессиями на локальных мобильных устройствах.
Взаимодействие с умными элементами: выполнять действия, такие как клики, ввод текста, скриншоты и поиск элементов.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

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