Ghost in the Droid

Ghost in the Droid — MCP-сервер сообщества (автор — ghost-in-the-droid). Управление настоящим Android или iPhone: 62 инструмента мобильной автоматизации. Ставится через uvx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ghost-in-the-droid
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

Полное управление телефоном через ADB (включая shell и intents) или WebDriverAgent; уведомления и буфер обмена; README советует отдельное устройство и аккаунты.

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

codex
{
    "code": "codex mcp add android-agent -- uvx --from ghost-in-the-droid android-agent-mcp",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Ghost in the Droid — открытый фреймворк на Python, который даёт любому ИИ-агенту настоящий Android-телефон или iPhone: читает экран, нажимает, листает и вводит текст, а также масштабируется от одного устройства на столе до целой фермы телефонов. Android управляется через ADB, iOS — через Appium XCUITest и WebDriverAgent. Лицензия MIT. В комплект входит MCP-сервер с 62 инструментами.

Инструменты MCP по README:

  • экран: скриншоты (в том числе с разметкой и обрезкой), элементы, дерево экрана, XML;
  • касания: нажатие по координатам и по элементу, свайп, долгое нажатие, ввод текста (включая Юникод), кнопки «Назад» и «Домой»;
  • приложения: запуск, поиск, список приложений и пакетов, intents, принудительная остановка;
  • понимание экрана: состояние телефона, классификация экрана, поиск на экране, OCR, извлечение видимого текста;
  • браузер: открытие URL, навигация назад, чтение новостей и статей, ожидание текста;
  • устройство: список устройств, буфер обмена, уведомления, состояние устройства;
  • навыки: список, запуск сценариев и действий, создание навыка, автоматическое исследование приложения;
  • пакетный запуск (run_flow / chain) и диагностика: сбои, веб-поиск, запись экрана, камера и синтез речи.

Повторяющиеся сценарии сохраняются как навыки — детерминированные рецепты на YAML и Python, которые выполняются без вызовов модели. Есть Skill Hub с навыками сообщества, панель управления с живой трансляцией экрана и очереди задач для фермы телефонов.

Кому подойдёт

  • Разработчикам агентов, которым нужен доступ агента к реальному мобильному устройству.
  • QA-инженерам и тем, кто автоматизирует мобильные приложения на нескольких устройствах сразу.

Похожие серверы — в категории автоматизация и IoT.

Установка

Требования: Python 3.10+. Для Android — телефон с включённой отладкой по USB и ADB в PATH (команда adb devices должна видеть телефон). Для iOS — macOS с Xcode, Appium 2 с драйвером XCUITest и доверенный iPhone или запущенный симулятор. Для панели управления нужен Node.js 18+.

MCP-сервер запускается через uvx без клонирования репозитория и виртуального окружения: пакет ghost-in-the-droid, команда android-agent-mcp.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add android-agent -- uvx --from ghost-in-the-droid android-agent-mcp

Такой же JSON README приводит для Claude Desktop (claude_desktop_config.json) и Windsurf (mcp_config.json). В VS Code Copilot (.vscode/mcp.json) тот же блок размещается под ключом servers.

Проверка

Подключите телефон, убедитесь, что adb devices его видит, и попросите ассистента вывести список устройств и сделать скриншот.

Примеры задач

Открой Play Store на телефоне, найди приложение «Погода» и сделай скриншот страницы.
Исследуй моё тестовое приложение, составь карту экранов и создай навык для входа под тестовым пользователем.

Риски

  • Полное управление устройством. Агент нажимает, вводит текст, запускает и останавливает приложения, читает уведомления и буфер обмена. На Android доступны команды ADB shell и intents.
  • Отдельное устройство. README советует отдать агенту старый Android с собственной SIM-картой и отдельными аккаунтами, физически отделённый от вашей личной жизни.
  • Правила приложений. Встроенные навыки автоматизируют, например, TikTok; автоматизация сторонних сервисов может нарушать их условия использования — проверяйте их заранее.
  • Данные. Сервер и панель работают локально. При облачной модели скриншоты и запросы уходят её провайдеру, при локальной — не покидают вашу сеть.
  • По умолчанию на Android ничего не устанавливается: экран читается через uiautomator, действия — через adb shell input, root и служба специальных возможностей не нужны.

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

Поддерживается ли iPhone?

Да, через Appium XCUITest и WebDriverAgent на macOS с Xcode. Часть инструментов (ADB shell, intents, Play Store) работает только на Android и на iOS возвращает понятную ошибку.

Нужен ли root?

Нет. Достаточно отладки по USB и ADB.

Основы протокола — на странице что такое MCP-сервер.

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

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники