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-команды, управляет вводом и приложениями на устройстве, передаёт файлы между компьютером и телефоном.

Настройка клиентов

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

Оценки популярности хип-хоп исполнителей по четырём культурным измерениям.

Риск: medium Лицензия: MIT ★ 114 818

Coder

Управление рабочими пространствами, шаблонами и облачными средами разработки Coder.

Риск: medium Лицензия: AGPL-3.0 ★ 17 363

Источники