scrcpy-mcp
scrcpy-mcp — MCP-сервер сообщества (автор — JuanCF). Управление Android-устройством через ADB и scrcpy. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- JuanCF
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Выполняет произвольные ADB shell-команды, управляет вводом и приложениями на устройстве, передаёт файлы между компьютером и телефоном.
Настройка клиентов
{
"code": "{\n \"android\": {\n \"command\": \"npx\",\n \"args\": [\"scrcpy-mcp\"]\n }\n}",
"lang": "json",
"notes": "Settings → MCP → Add Server",
"verified": "docs"
}
Что умеет
scrcpy-mcp — MCP-сервер, который даёт ИИ-агентам полное зрение и управление Android-устройствами через ADB и scrcpy. Подключите Claude Code, OpenCode, Cursor, VS Code Copilot или другой MCP-клиент к телефону — и агент сможет видеть экран, нажимать, свайпать, вводить текст, запускать приложения, исследовать элементы интерфейса, передавать файлы и выполнять shell-команды.
Всего 44 инструмента:
- Сессия — запуск и остановка сессии scrcpy (ввод в 10–50 раз быстрее, снимки экрана примерно за 33 мс), версия scrcpy-server. Параметры: размер кадра, FPS, захват звука, удержание экрана включённым.
- Устройство — список устройств, сведения (модель, версия Android, экран, батарея), включение и выключение экрана, поворот, шторка уведомлений и быстрых настроек, подключение ADB по Wi-Fi.
- Зрение — снимок экрана, который возвращается как изображение, запись экрана с выгрузкой на компьютер, видеопоток MJPEG с окном просмотра.
- Ввод — нажатие, свайп, долгое нажатие, перетаскивание, ввод текста, клавиши HOME, BACK, ENTER, громкость, питание, прокрутка.
- Приложения — запуск по имени пакета, принудительная остановка, установка APK с компьютера, удаление, список пакетов, текущее приложение.
- Автоматизация UI — дамп иерархии интерфейса в XML и поиск элементов по тексту, ID ресурса, классу или описанию с координатами для нажатия.
- Shell и файлы —
shell_execвыполняет произвольную ADB shell-команду; передача файлов на устройство и с него, просмотр каталогов. - Буфер обмена — чтение и запись, работает и на Android 10+ благодаря scrcpy.
- Звук — трансляция звука устройства на динамики компьютера, запись в WAV или Opus, захват короткого фрагмента.
Без scrcpy инструменты ввода работают через ADB — медленнее, но всегда доступно; звук и видеопоток требуют scrcpy.
Кому подойдёт
- Мобильным разработчикам и тестировщикам, автоматизирующим проверки Android-приложений.
- QA-инженерам, которым нужен агент, видящий экран и действующий по нему.
- Энтузиастам автоматизации, управляющим телефоном с компьютера.
Похожие серверы — в категории автоматизация и IoT.
Установка
Нужны Node.js 24+, ADB (Android Platform Tools) и устройство с включённой отладкой по USB (для звука — Android 11+). Для ускорения установите scrcpy, для видео и записи звука — ffmpeg и ffplay. Включите режим разработчика (семь нажатий на «Номер сборки»), отладку по USB, подключите устройство, подтвердите RSA-отпечаток и проверьте adb devices. Запуск — npx scrcpy-mcp или глобально npm install -g scrcpy-mcp. Переменные ADB_PATH, ANDROID_SERIAL, SCRCPY_SERVER_PATH, FFMPEG_PATH и FFPLAY_PATH задают пути и устройство по умолчанию.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add android -- npx scrcpy-mcpВ Cursor сервер добавляется через «Settings → MCP → Add Server». Конфиг Claude Desktop — ~/.config/Claude/claude_desktop_config.json в Linux или %APPDATA%\Claude\claude_desktop_config.json в Windows; тот же JSON подходит для .mcp.json в Claude Code и OpenCode. Для VS Code — .vscode/mcp.json. В OpenCode переменные передаются ключом environment, а не env.
Проверка
Попросите агента: «Покажи список подключённых устройств и сделай снимок экрана» — сработают device_list и screenshot.
Примеры задач
Открой настройки на телефоне, найди раздел Wi-Fi и сделай снимок экрана.Установи app-debug.apk, запусти приложение и проверь, что на главном экране есть кнопка «Войти».Риски
- Полный контроль над устройством. Агент выполняет произвольные shell-команды через ADB, устанавливает и удаляет приложения, нажимает и вводит текст от вашего имени — подключайте тестовое устройство, а не основной телефон с банковскими приложениями.
- Файлы. Инструменты передачи читают и записывают файлы на компьютере и устройстве.
- Приватность. Снимки экрана, буфер обмена и звук передаются модели. Захват звука по умолчанию отключает динамики устройства на время записи.
Частые вопросы
Обязателен ли scrcpy?
Нет, без него инструменты работают через ADB медленнее; видеопоток и звук требуют scrcpy.
Можно ли подключиться без кабеля?
Да, инструмент connect_wifi включает ADB по Wi-Fi.
Какая версия Android нужна?
Любая с отладкой по USB; для захвата звука — Android 11+.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
paperclip
Оценки популярности хип-хоп исполнителей по четырём культурным измерениям.
Coder
Управление рабочими пространствами, шаблонами и облачными средами разработки Coder.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.