Android MCP: агент управляет телефоном через adb или приложение

CursorTouch/Android-MCP· Проверено 12.11.2026· 924на GitHub

Даёт агенту управлять Android-телефоном или эмулятором: читать элементы экрана, нажимать, листать, печатать и запускать приложения. Отдельный вариант снимает сетевой трафик телефона для разбора запросов.

3 реализации:

Работает на компьютере через adb: на телефон ничего не ставится, устройство подключается по USB или Wi-Fi.

Как подключить

Что сделать до подключения

Python 3.13 и uv

adb из Android platform-tools: в PATH, в ANDROID_HOME или через переменную ANDROID_MCP_ADB_PATH

Склонировать репозиторий и указать путь к папке в аргументе --directory

Для кириллицы и эмодзи поставить на телефон приложение ADBKeyboard

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio android \
  -- uv --directory '<путь к папке Android-MCP>' run android-mcp-beta

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.android]
command = "uv"
args = ["--directory", "<путь к папке Android-MCP>", "run", "android-mcp-beta"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "android": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "android": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к папке Android-MCP>",
          "run",
          "android-mcp-beta"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "android": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке Android-MCP>",
        "run",
        "android-mcp-beta"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

ListDevicesперечисляет подключённые устройства

ConnectDeviceвыбирает устройство

Deviceотключает устройство

Snapshotчитает элементы экрана с координатами

Clickнажимает по координатам

LongClickдолго нажимает по координатам

Swipeпроводит пальцем по экрану

Dragперетаскивает элемент

ClickBySelectorнажимает элемент по тексту или id

Typeвводит текст в поле

Pressнажимает системную кнопку

Notificationоткрывает шторку уведомлений

Waitделает паузу

WaitForElementждёт появления элемента

Приложение на самом телефоне поднимает HTTP-сервер: 65 инструментов, файлы, камера, уведомления, доступ через интернет по туннелю, без adb и компьютера рядом.

Как подключить

Что сделать до подключения

Скачать APK со страницы Releases: сборка GMS для телефона с Google Play, FOSS для телефона без сервисов Google

В приложении включить службу специальных возможностей (Accessibility Service), без неё ничего не работает

На вкладке Server нажать Start и взять адрес, порт и токен

По умолчанию сервер слушает 127.0.0.1 телефона: выполнить adb forward tcp:8080 tcp:8080, выбрать адрес 0.0.0.0 или включить туннель

Authorization

Bearer-токен создаётся при первом запуске приложения, его видно и можно скопировать на вкладке Server

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http android-remote-control-mcp http://<IP телефона>:8080/mcp \
  --header 'Authorization: Bearer <токен из вкладки Server>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.android-remote-control-mcp]
url = "http://<IP телефона>:8080/mcp"
http_headers = { "Authorization" = "Bearer <токен из вкладки Server>" }

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "android-remote-control-mcp": {
      "url": "http://<IP телефона>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <токен из вкладки Server>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "android-remote-control-mcp": {
      "type": "http",
      "url": "http://<IP телефона>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <токен из вкладки Server>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "android-remote-control-mcp": {
      "httpUrl": "http://<IP телефона>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <токен из вкладки Server>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "android-remote-control-mcp": {
      "httpUrl": "http://<IP телефона>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <токен из вкладки Server>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "android-remote-control-mcp": {
        "type": "remote",
        "url": "http://<IP телефона>:8080/mcp",
        "headers": {
          "Authorization": "Bearer <токен из вкладки Server>"
        }
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://<IP телефона>:8080/mcp
Request headers: Authorization: Bearer <токен из вкладки Server>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "android-remote-control-mcp": {
      "url": "http://<IP телефона>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <токен из вкладки Server>"
      }
    }
  }
}

Инструменты сервера

android_get_screen_stateчитает экран и делает скриншот

android_find_nodesищет элементы на экране

android_click_nodeнажимает найденный элемент

android_tapнажимает по координатам

android_swipeпроводит пальцем

android_scroll_to_nodeлистает до элемента

android_type_replace_textзаменяет текст в поле

android_press_backнажимает «Назад»

android_wait_for_nodeждёт появления элемента

android_open_appзапускает приложение

android_list_appsперечисляет установленные приложения

android_list_filesпоказывает файлы в хранилище

android_read_fileчитает файл с телефона

android_download_from_urlскачивает файл на телефон

android_take_camera_photoснимает фото камерой

android_notification_listчитает уведомления

android_notification_replyотвечает на уведомление

android_get_locationопределяет местоположение

android_open_uriоткрывает ссылку

android_shell_execвыполняет команду shell

Показано 20 из 65.

Телефоном не управляет: через прокси mitmdump собирает HTTP- и HTTPS-трафик телефона, а агент ищет и разбирает запросы.

Как подключить

Что сделать до подключения

Python 3.11 или новее и uv

Склонировать репозиторий и выполнить uv sync

Запустить прокси командой uv run android-proxy-start и держать терминал открытым

На телефоне в той же сети Wi-Fi вручную указать прокси: IP компьютера и порт 8288

Для HTTPS открыть на телефоне http://mitm.it и поставить CA-сертификат

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio android-proxy-mcp \
  -- uv --directory '<путь к папке android_proxy_mcp>' run android-proxy-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.android-proxy-mcp]
command = "uv"
args = ["--directory", "<путь к папке android_proxy_mcp>", "run", "android-proxy-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "android-proxy-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "android-proxy-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "android-proxy-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "android-proxy-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "android-proxy-mcp": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к папке android_proxy_mcp>",
          "run",
          "android-proxy-mcp"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "android-proxy-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "android-proxy-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к папке android_proxy_mcp>",
        "run",
        "android-proxy-mcp"
      ]
    }
  }
}

Инструменты сервера

proxy_statusпроверяет состояние прокси

traffic_listперечисляет запросы с фильтрами

traffic_searchищет в адресах, заголовках и телах

traffic_get_detailчитает заголовки запроса и ответа

traffic_read_bodyчитает большой ответ частями

traffic_clearочищает записанный трафик

get_cert_infoвыдаёт инструкцию по сертификату

Что попросить агента

«Открой на телефоне <приложение>, найди <товар> и добавь его в корзину»Android-MCP снимет экран через Snapshot, нажмёт нужные элементы через ClickBySelector или Click и введёт запрос через Type

«Установи из Google Play приложение <название>»Android Remote Control MCP откроет магазин через android_open_app, найдёт поле поиска через android_find_nodes и пройдёт установку через android_click_node

«Прочитай новые уведомления и ответь в <мессенджер>, что я перезвоню»Android Remote Control MCP прочитает шторку через android_notification_list и ответит через android_notification_reply

«Покажи все неудачные запросы с кодом 4xx или 5xx»Android Proxy MCP отфильтрует записанный трафик через traffic_list и покажет подробности через traffic_get_detail

«Найди в трафике приложения <название> запрос поиска и разбери его параметры»Android Proxy MCP найдёт запрос через traffic_search и прочитает ответ частями через traffic_read_body

Для каких задач

Пройти сценарий в приложении на телефоне или эмуляторе: открыть, нажать, ввести текст

Найти на экране кнопку по тексту или id и нажать её

Прочитать и закрыть уведомления, ответить на сообщение из шторки

Скачать файл на телефон, прочитать его или снять фото камерой

Найти в трафике телефона нужный API-запрос и разобрать его параметры

Ограничения

Android-MCP без приложения ADBKeyboard печатает только латиницу: кириллицу и эмодзи команда Type отклоняет

На экране, который не замирает (видео, таймер), Android-MCP не получает список элементов и отдаёт только скриншот

Android Remote Control MCP со службой специальных возможностей управляет телефоном как вы, а shell-инструменты включены по умолчанию: не ставьте его на телефон с важными данными

Android Proxy MCP с 246 звёздами и последним обновлением в феврале 2026 года; на Android 7 и новее приложения не доверяют пользовательскому сертификату, и их HTTPS без root не виден

Если не работает

Type в Android-MCP отказывается печатать русский текст

Поставьте на телефон ADBKeyboard командой adb install keyboardservice-debug.apk: сервер сам переключит на неё клавиатуру на время ввода. Поле ввода должно быть в фокусе.

Snapshot отдаёт только скриншот без списка элементов

Экран не замирает: идёт видео или таймер, и uiautomator dump сдаётся. Нажимайте по координатам со скриншота.

Переключатель службы специальных возможностей серый, пишет «Restricted setting»

Это защита Android 13 и новее для приложений из APK. Откройте Настройки → Приложения → Android Remote Control MCP → О приложении, меню ⋮ → Allow restricted settings, затем включите службу.

Claude.ai не подключается к Android Remote Control MCP по локальному адресу

Коннектору Claude.ai и ChatGPT нужен публичный HTTPS: адрес localhost, адрес в локальной сети и adb forward не подойдут. Включите туннель в Settings → Tunnel и добавьте адрес https://…/mcp.

После настройки прокси Android Proxy MCP телефон не открывает сайты

Проверьте, что телефон и компьютер в одной сети Wi-Fi, прокси запущен в терминале, брандмауэр пропускает порт 8288, а в настройках указан IP компьютера вместо localhost.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Android-MCP	CursorTouch	924	локально	не нужен	14	11 ноября 2026
Android Remote Control MCP	Daniele Albano	827	HTTP	токен	65	10 ноября 2026
Android Proxy MCP	zhizhuodemao	246	локально	не нужен	7	9 февраля 2026

Частые вопросы

Что нужно поставить на телефон?

Для Android-MCP ничего: он работает через adb с компьютера, нужна только отладка по USB или Wi-Fi. Android Remote Control MCP — это APK, который ставится на телефон. Android Proxy MCP требует прокси в настройках Wi-Fi и CA-сертификат для HTTPS.

Можно ли подключить эмулятор вместо телефона?

Да. Android-MCP без настроек берёт первое физическое устройство, а если его нет — эмулятор. Android Remote Control MCP тоже ставится на эмулятор.

Как управлять телефоном, если он не рядом с компьютером?

У Android Remote Control MCP есть бесплатный туннель со сквозным шифрованием без аккаунта: включите Remote Access в Settings → Tunnel и возьмите публичный адрес https://…/mcp. Поддерживаются и Cloudflare Quick Tunnels и ngrok.

Как выбрать конкретное устройство, если подключено несколько?

В Android-MCP передайте серийный номер флагом --device или переменной ANDROID_MCP_DEVICE, для устройства в сети — host:port. Флаг --wifi подключает по adb через Wi-Fi, порт по умолчанию 5555.

Видит ли нейросеть мои личные данные с экрана?

Видит то, что на экране. В Android Remote Control MCP есть Privacy Mode: модель на телефоне прячет почту, номера карт, пароли и телефоны до отправки. Имена она находит плохо, команды shell через неё не проходят.

Есть ли Android MCP на Python?

Да, Android-MCP и Android Proxy MCP написаны на Python и запускаются через uv: первому нужен Python 3.13 и adb, второму Python 3.11 и прокси mitmdump. Android Remote Control MCP — приложение для самого телефона.

Что такое Android Remote Control MCP?

Приложение для Android, которое запускает MCP-сервер прямо на телефоне по адресу http://<IP>:8080/mcp. Оно работает через службу специальных возможностей без root и adb и даёт 65 инструментов: экран, касания, файлы, камеру, уведомления и shell.

Работает ли сервер из России?

Android-MCP и Android Proxy MCP работают на вашем компьютере, Android Remote Control MCP — на самом телефоне; аккаунты не нужны, туннель для доступа из интернета у Android Remote Control MCP бесплатный и без регистрации.

Android MCP: агент управляет телефоном через adb или приложение

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы