Appium MCP
appium-mcp
Агент открывает сеансы на эмуляторах и реальных устройствах, ищет элементы по описанию и пишет тесты на Java через сервер Appium.
- 518 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Управляет устройством: ставит приложения, нажимает, вводит текст и снимает экран.
- На реальном устройстве агенту видны личные данные и аккаунты в открытых приложениях.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/appium-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет устройством: ставит приложения, нажимает, вводит текст и снимает экран.
- На реальном устройстве агенту видны личные данные и аккаунты в открытых приложениях.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
appium-mcp — MCP-сервер для автоматизации мобильных приложений на Android (UiAutomator2) и iOS (XCUITest). Агент создает сеанс на эмуляторе, симуляторе или реальном устройстве, находит элементы, нажимает, вводит текст, снимает скриншоты и записывает экран. Для тестов есть генерация кода на Java с TestNG по описанию сценария и шаблоны Page Object. Поиск элементов по описанию вроде «кнопка входа» включают отдельно: ему нужна визуальная модель с OpenAI-совместимым API. Сервер запускается по stdio командой `npx appium-mcp@latest`, для HTTP есть режим `--httpStream`. Встроенные драйверы работают локально, а к готовому серверу Appium подключаются по `remoteServerUrl`.
Для кого. QA-инженерам и мобильным разработчикам, которые гоняют сценарии на Android и iOS через агента.
Подходит, если
- Агент проходит сценарий в приложении на эмуляторе и фиксирует каждый шаг скриншотом.
- По описанию сценария нужен тест на Java с TestNG.
- Локаторы подбирают после того, как XPath ломается при каждом релизе.
- Приложение проверяют на реальном iPhone или Android-устройстве, подключенном к машине.
Не подходит, если
- Тесты нужны на Python или JavaScript: готовый генератор рассчитан на Java с TestNG.
- На машине нет Android SDK, JDK и Xcode.
- Скриншоты экрана нельзя отправлять внешней визуальной модели.
Пример запроса к агенту
Запусти приложение на эмуляторе Android, найди кнопку входа и пройди сценарий оформления заказа, прикладывая скриншоты.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
`ANDROID_HOME`- Путь к Android SDK, нужен для Android.
`CAPABILITIES_CONFIG`- Абсолютный путь к `capabilities.json` с настройками по платформам.
`AI_VISION_ENABLED`- `true` включает инструмент `appium_ai` для поиска по описанию.
`AI_VISION_API_BASE_URL`- Адрес OpenAI-совместимого API визуальной модели, обязателен при включенном поиске.
`AI_VISION_API_KEY`секрет- Ключ провайдера визуальной модели, обязателен при включенном поиске.
Ограничения
Нужны Node.js 22 или новее, JDK 8 и выше, Android SDK с `ANDROID_HOME` и Xcode для iOS (только macOS). Для реального iPhone включают Developer Mode и входят в Apple ID в Xcode. Режим поиска по описанию отправляет скриншоты визуальной модели по ключу `AI_VISION_API_KEY`. HTTP-транспорт держите на loopback: проверка Origin не заменяет аутентификацию. Установку приложений по URL ограничивает `ALLOW_REMOTE_APP_URLS=false`.
Как отключить. Удалите блок `appium-mcp` из конфигурации клиента. Скриншоты и записи экрана остаются в `SCREENSHOTS_DIR` или во временном каталоге системы.
Частые вопросы
Какие платформы поддерживает сервер?
Android через UiAutomator2 и iOS через XCUITest: эмуляторы, симуляторы и реальные устройства.
Как включить поиск элементов по описанию?
Задайте `AI_VISION_ENABLED=true`, `AI_VISION_API_BASE_URL` и `AI_VISION_API_KEY`: тогда регистрируется инструмент `appium_ai`. Модель по умолчанию Qwen3-VL-235B-A22B-Instruct.
Можно ли подключиться к готовому серверу Appium?
Да. Передайте `remoteServerUrl` в `appium_session_management` с `action=create` или `attach`. Допустимые адреса ограничивает регулярное выражение в `REMOTE_SERVER_URL_ALLOW_REGEX`.
Что с сеансами при отключении клиента?
По умолчанию `APPIUM_MCP_ON_CLIENT_DISCONNECT=delete_all` удаляет сеансы, которые создал сервер.
Где сохраняются скриншоты и записи экрана?
В каталоге из `SCREENSHOTS_DIR`, по умолчанию это временный каталог системы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
Android MCP Server — управление Android через ADB
Android MCP Server
MCP-сервер на Python: агент делает снимок экрана Android-устройства, читает кликабельные элементы интерфейса и выполняет команды ADB
MCP-сервер, который ставится на iPhone с джейлбрейком и дает агенту 46 инструментов: касания, снимки экрана, OCR, приложения, файлы, логи
MCP-сервер дает агенту экран Android, поиск элементов, нажатия, ввод и снимки для проверки собственных приложений.
MCP-сервер управления Android через ADB и scrcpy: агент видит экран, нажимает, вводит текст и открывает приложения.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Appium MCP (эта карточка) | да | не нужна | 518 | |
| Mobile MCP | нет | не нужна | 10 325 | управляет iOS и Android через дерево доступности и скриншоты; appium-mcp использует драйверы Appium, генерирует тесты Java и TestNG и ищет элементы по описанию |
| Alumnium | нет | API-ключ | 1 022 | Alumnium дает агенту сквозные тесты через MCP |
| SoloPi | нет | 6 364 | скилл для тестов Android на настоящих устройствах |
Коротко о README
README перечисляет возможности, требования к системе и настройку Android и iOS. Затем идут конфигурации для Cursor, Gemini CLI и Claude Code, таблица переменных окружения, безопасность HTTP-транспорта и API плагинов. Разделы про инструменты сгруппированы по сеансам, элементам, экрану и приложениям.