scrcpy-mcp
MCP-сервер управления Android через ADB и scrcpy: агент видит экран, нажимает, вводит текст и открывает приложения.
- 129 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент видит весь экран и нажимает что угодно, а `shell_exec` выполняет произвольные команды на устройстве.
- Файлы, буфер обмена и звук устройства доступны агенту и уходят его модели.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/scrcpy-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент видит весь экран и нажимает что угодно, а `shell_exec` выполняет произвольные команды на устройстве.
- Файлы, буфер обмена и звук устройства доступны агенту и уходят его модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
scrcpy-mcp подключает агента к телефону или планшету на Android по USB либо по Wi-Fi. В наборе 44 инструмента: скриншоты, касания и свайпы, ввод текста, запуск приложений, поиск элементов интерфейса, файлы, буфер обмена, запись экрана, потоковое видео и запись звука. При включенной сессии scrcpy ввод и снимки экрана идут по бинарному протоколу scrcpy, а скриншот занимает около 33 мс. Без scrcpy те же инструменты работают через ADB, только медленнее. Агент получает скриншот изображением, а `ui_find_element` возвращает координаты касания.
Для кого. Мобильным разработчикам и тестировщикам, которые хотят поручить агенту проход по приложению на реальном Android-устройстве.
Подходит, если
- Сборка установлена на телефон, и агент должен пройти сценарий регистрации и сообщить, где он сломался.
- Нужно снять серию скриншотов экранов приложения без ручных касаний.
- Агенту надо вытащить файл с устройства или положить на него тестовый.
- Звук приложения записывается в `.wav` для проверки воспроизведения.
Не подходит, если
- На устройстве личные аккаунты и банковские приложения: агент видит весь экран и может нажать что угодно.
- Нужен iOS: сервер работает только с Android.
- Достаточно эмулятора с готовым MCP, а физическое устройство под рукой не нужно.
Пример запроса к агенту
Открой приложение на телефоне, пройди экран входа тестовым логином и пришли скриншот главного экрана.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
SCRCPY_SERVER_PATH- Путь к нестандартному файлу scrcpy-server.
SCRCPY_SERVER_VERSION- Версия scrcpy-server, задается только при сбое автоопределения.
Ограничения
Нужны Node.js 24 или новее, ADB и Android-устройство с отладкой по USB; запись звука требует Android 11 или новее. Scrcpy ускоряет работу, но ставится отдельно, а для потока видео и записи звука еще нужны ffmpeg и ffplay. Источник звука `output` отключает динамики самого устройства на время захвата: звук переносится на компьютер, а не копируется. Версию scrcpy-server задают вручную только тогда, когда автоопределение не сработало, иначе устаревшее значение вызывает конфликт версий.
Как отключить. Удалите MCP-запись android из конфигурации клиента и отключите отладку по USB на устройстве. Если включали ADB по Wi-Fi, вызовите `disconnect_wifi`.
Частые вопросы
Как подключить к Claude Code?
Выполните `claude mcp add android -- npx scrcpy-mcp`. Для Cursor, Claude Desktop и VS Code README дает JSON с командой `npx` и аргументом `scrcpy-mcp`.
Нужен ли scrcpy?
Нет. Инструменты управления работают через ADB и без него, но ввод идет в 10–50 раз медленнее, а видеопоток и звук недоступны.
Как подключиться по воздуху?
Инструмент `connect_wifi` включает ADB по Wi-Fi и возвращает адрес подключения. Отключиться можно через `disconnect_wifi`.
Может ли агент выполнять команды на телефоне?
Да, инструмент `shell_exec` выполняет произвольную ADB-команду и возвращает вывод. Доступ широкий, поэтому подключайте сервер к тестовому устройству.
Что делать при ошибке версии scrcpy-server?
Сверьте значение `SCRCPY_SERVER_VERSION` с выводом `scrcpy --version` либо удалите переменную, чтобы версия определялась автоматически.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыAndroid MCP Server — управление Android через ADB
Android MCP Server
MCP-сервер на Python: агент делает снимок экрана Android-устройства, читает кликабельные элементы интерфейса и выполняет команды ADB
MCP-сервер дает агенту экран Android, поиск элементов, нажатия, ввод и снимки для проверки собственных приложений.
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
Android Remote Control MCP
android-remote-control-mcp
Приложение Android, которое превращает телефон или эмулятор в сервер MCP: службы доступности и снимки экрана
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
Appium MCP
appium-mcp
Агент открывает сеансы на эмуляторах и реальных устройствах, ищет элементы по описанию и пишет тесты на Java через сервер Appium.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| scrcpy-mcp (эта карточка) | нет | не нужна | 129 | |
| Android MCP | нет | не нужна | 917 | управляет Android через ADB; scrcpy-mcp при включенном scrcpy вводит команды заметно быстрее и пишет звук устройства |
| Mobile MCP | нет | не нужна | 10 325 | охватывает iOS и Android через дерево доступности; scrcpy-mcp ограничен Android, но дает видеопоток и запись звука |
Коротко о README
В README перечислены все 44 инструмента по группам: управление сессией, видео, звук, устройство, зрение, ввод, приложения, оболочка и файлы. Отдельно описан разбор типичных неполадок: конфликт версий, каталог вместо файла сервера на устройстве.