scrcpy-mcp — MCP-сервер для Claude Code: управление Android
Даёт ИИ-агенту доступ к экрану и управлению Android-устройством через ADB и scrcpy. Пригодится для проверки интерфейса и выполнения действий на телефоне.
claude mcp add --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ADB_PATH=<ADB_PATH> --env SCRCPY_SERVER_PATH=<SCRCPY_SERVER_PATH> --transport stdio scrcpy-mcp -- npx -y scrcpy-mcpЧто делает scrcpy-mcp
Сервер позволяет агенту смотреть на экран устройства, нажимать и свайпать, вводить текст, запускать приложения, находить элементы интерфейса, передавать файлы и выполнять команды оболочки. Скриншоты возвращаются как изображения, а поиск элемента может дать координаты для нажатия. Есть инструменты для буфера обмена, видео и аудио.
Для работы нужны Node.js 24+, ADB и Android-устройство с включённой USB-отладкой. scrcpy ускоряет управление, но базовые действия доступны и через ADB, медленнее. Потоковое видео и аудио требуют scrcpy; захват аудио работает на Android 11+ и должен быть включён явно. Без USB-отладки сервер не сможет подключиться к устройству.
В Claude Code сервер добавляется командой claude mcp add scrcpy-mcp -- npx -y scrcpy-mcp. Для выбора устройства и собственных путей к ADB или scrcpy можно передать переменные окружения через расширенную команду установки.
Какие задачи решает
- посмотреть экран Android-устройства из агента
- нажать на элемент интерфейса по его координатам
- запустить приложение и ввести в него текст
- передать файлы между устройством и компьютером
- записать или передать аудио с устройства
Примеры запросов агенту
- Посмотри на экран подключённого Android-устройства и скажи, что на нём открыто.
- Открой приложение и нажми кнопку входа.
- Найди на экране поле поиска и введи в него название приложения.
Как установить scrcpy-mcp
Командой платформы
claude mcp add --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ADB_PATH=<ADB_PATH> --env SCRCPY_SERVER_PATH=<SCRCPY_SERVER_PATH> --transport stdio scrcpy-mcp -- npx -y scrcpy-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add scrcpy-mcp --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ADB_PATH=<ADB_PATH> --env SCRCPY_SERVER_PATH=<SCRCPY_SERVER_PATH> -- npx -y scrcpy-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"scrcpy-mcp": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
],
"env": {
"ANDROID_SERIAL": "<ANDROID_SERIAL>",
"ADB_PATH": "<ADB_PATH>",
"SCRCPY_SERVER_PATH": "<SCRCPY_SERVER_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"scrcpy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
],
"env": {
"ANDROID_SERIAL": "<ANDROID_SERIAL>",
"ADB_PATH": "<ADB_PATH>",
"SCRCPY_SERVER_PATH": "<SCRCPY_SERVER_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ANDROID_SERIAL=<ANDROID_SERIAL> -e ADB_PATH=<ADB_PATH> -e SCRCPY_SERVER_PATH=<SCRCPY_SERVER_PATH> scrcpy-mcp npx -y scrcpy-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о scrcpy-mcp
Как установить scrcpy-mcp в Claude Code?
Выполните claude mcp add scrcpy-mcp -- npx -y scrcpy-mcp. Для запуска нужны Node.js 24+, ADB и Android-устройство с USB-отладкой.
Что делает scrcpy-mcp?
Подключает ИИ-агента к Android-устройству через ADB и scrcpy: агент может видеть экран, нажимать, вводить текст, запускать приложения и работать с файлами.
Нужен ли scrcpy для работы scrcpy-mcp?
Для базового управления можно использовать ADB без scrcpy, но действия будут медленнее. Потоковое видео и аудио требуют scrcpy; аудиозахват доступен на Android 11+.
