Ghost in the Droid MCP
62 MCP-инструмента, чтобы агент нажимал, листал и вводил текст на реальном Android по ADB или на iPhone.
- 413 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент нажимает и печатает на реальном телефоне, включая оболочку ADB и намерения Android.
- Экран может содержать личные данные и коды; облачная модель получает скриншоты.
Установка
- Работает в
Ручная установка
uvx ghost-in-the-droid doctorПервая команда Quick Start из README, проверка окружения. Дальше `uvx ghost-in-the-droid up` запускает сервер и панель на `localhost:5055`. Через pipx: `pipx install ghost-in-the-droid`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент нажимает и печатает на реальном телефоне, включая оболочку ADB и намерения Android.
- Экран может содержать личные данные и коды; облачная модель получает скриншоты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ghost in the Droid управляет реальным Android по ADB и iPhone через Appium и WebDriverAgent. Агент читает экран, нажимает, свайпает и печатает текст через 62 MCP-инструмента. Android-сервер запускается командой `android-agent-mcp`. Повторяющиеся сценарии оформляют как скиллы: YAML-описание элементов плюс Python-действия, которые выполняются без вызовов модели. Скиллы ставятся из хаба командой `android-agent skill install tiktok`. Вместе с MCP идут панель управления с потоком экрана, CLI `ghost` и очереди задач для нескольких устройств.
Для кого. Разработчикам и тестировщикам мобильных приложений, которые поручают агенту прогон сценариев на реальном телефоне или ферме устройств.
Подходит, если
- Claude Code проходит сценарий в приложении на подключенном Android и снимает скриншоты.
- Для часто повторяемого действия в приложении нужен скилл, который выполняется без токенов.
- На нескольких устройствах параллельно идут проверки с очередью задач.
- Модель должна работать локально на Ollama или внутри самого телефона.
Не подходит, если
- Нужна автоматизация только в браузере, без физического телефона.
- На телефоне хранятся личные аккаунты и данные, которые агент не должен видеть.
- Работа с iPhone нужна без macOS и Xcode.
Пример запроса к агенту
Подключи телефон по ADB, открой приложение Play Store, найди нужное приложение и покажи экран результата, не устанавливая его.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
`GITD_ENABLE_IOS`- Включает управление iPhone через Appium и WebDriverAgent. Значение `1`.
Ограничения
Нужны Python 3.10 или новее и ADB в PATH, на телефоне включена отладка по USB. Для iPhone требуются macOS, Xcode, Appium 2 с драйвером XCUITest и подпись WebDriverAgent; режим включается переменной `GITD_ENABLE_IOS=1`. Инструменты `shell` и `launch_intent` работают только на Android. Облачная модель получает скриншоты экрана, поэтому для приватности выбирайте локальную или встроенную в телефон. Последний коммит в августе 2026.
Как отключить. Удалите запись `android-agent` из конфигурации MCP и остановите панель, запущенную командой `ghost-in-the-droid up`. Выключите отладку по USB на телефоне. Если ставили приложение Portal, удалите его с устройства.
Частые вопросы
Нужен ли root на телефоне?
Нет. По README чтение экрана идет через `uiautomator`, действия через `adb shell input`, без root и службы доступности. Приложение Portal ускоряет чтение интерфейса, но не обязательно.
Как проверить окружение?
Выполните `uvx ghost-in-the-droid doctor`. Команда выведет чек-лист: Python, ADB в PATH, устройства, порты и ключи моделей, с подсказками по исправлению.
Какие модели можно подключить?
Claude Code по подписке, API Anthropic, OpenRouter, Ollama, vLLM либо модель внутри телефона через llama.cpp, MediaPipe или MLX.
Что с входом по подписке Claude?
`android-agent login` запускает вход через собственный OAuth-процесс CLI `claude`. По README Ghost не хранит токен: им владеет `claude`.
Как поставить готовый скилл для приложения?
Выполните `android-agent skill install tiktok`, подставив имя нужного скилла из хаба. Скилл выполняется без вызовов модели.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
MCP-сервер управления Android через ADB и scrcpy: агент видит экран, нажимает, вводит текст и открывает приложения.
MCP-сервер дает агенту экран Android, поиск элементов, нажатия, ввод и снимки для проверки собственных приложений.
Скилл и CLI для управления Android-телефоном через ADB и vision-модели: агент открывает приложения, ищет, заказывает и проверяет результат
MCP-сервер внутри Android-приложения MagicDesk: агент управляет окнами, терминалами, файлами и Linux на телефоне
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ghost in the Droid (эта карточка) | нет | не нужна | 413 | |
| Mobile MCP | нет | не нужна | 10 325 | mobile-mcp дает узкий набор инструментов для устройств; Ghost добавляет скиллы без вызовов модели, панель и ферму устройств |
| Android MCP Server — управление Android через ADB | нет | не нужна | 811 | android-mcp-server управляет только Android; Ghost работает и с iPhone |
Коротко о README
Фреймворк управляет Android и iOS из одной обвязки агента. Навыки под приложения описываются YAML и Python, выполняются без вызовов модели, а панель показывает живой поток экрана.