Ghost in the Droid — MCP-сервер для Claude Code: как установить
MCP-сервер подключает LLM к смартфонам и эмуляторам на Android и iOS. Он даёт агенту 62 инструмента: считывание экрана, нажатия, свайпы и ввод текста.
claude mcp add android-agent -- uvx ghost-in-the-droidЧто делает Ghost in the Droid
Сервер превращает мобильный телефон в исполнительное устройство для ИИ-агентов вроде Claude Code, Codex или Cursor. Набор из 62 инструментов позволяет анализировать изображение на дисплее, нажимать кнопки, листать списки и вводить текст в поля ввода. Связь с Android работает через протокол ADB по кабелю или Wi-Fi, а автоматизация iOS опирается на связку Appium и WebDriverAgent.
Архитектура принимает внешние модели через API, локальные серверы Ollama и vLLM или запуск весов прямо на процессоре телефона с помощью llama.cpp и MediaPipe. При этом эмуляция через Docker с KVM возможна только для Android. Для работы со средой iOS обязательно понадобятся macOS и установленный Xcode.
Сервер требует наличия Python версии 3.10 или новее. Запуск выполняется через утилиту uvx.
Какие задачи решает
- Управлять мобильными приложениями на реальных Android и iOS через диалог с агентом
- Автоматизировать тестирование интерфейсов мобильных приложений
- Передавать команды тапов и свайпов на ферму телефонов через единый протокол MCP
- Считывать текущее состояние экрана смартфона для многошаговых сценариев
Примеры запросов агенту
- Открой приложение Настройки на подключённом Android-устройстве и найди раздел с Wi-Fi.
- Сделай снимок экрана телефона и нажми на кнопку входа в аккаунт.
- Пройди стартовые экраны онбординга в приложении на iPhone через WebDriverAgent.
Как установить Ghost in the Droid
Командой платформы
claude mcp add android-agent -- uvx ghost-in-the-droiduvx запускает команду с именем пакета; если в README она другая — uvx --from ghost-in-the-droid <команда>
Командой платформы
codex mcp add ghost-in-the-droid -- uvx ghost-in-the-droiduvx запускает команду с именем пакета; если в README она другая — uvx --from ghost-in-the-droid <команда>
Файл настроек
{
"mcpServers": {
"ghost-in-the-droid": {
"command": "uvx",
"args": [
"ghost-in-the-droid"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ghost-in-the-droid <команда>
Файл настроек
{
"servers": {
"ghost-in-the-droid": {
"type": "stdio",
"command": "uvx",
"args": [
"ghost-in-the-droid"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ghost-in-the-droid <команда>
Командой платформы
gemini mcp add ghost-in-the-droid uvx ghost-in-the-droiduvx запускает команду с именем пакета; если в README она другая — uvx --from ghost-in-the-droid <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Ghost in the Droid
Как установить Ghost in the Droid в Claude Code?
Выполните в терминале команду claude mcp add ghost-in-the-droid -- uvx ghost-in-the-droid. Менеджер uvx автоматически загрузит нужные пакеты и запустит сервер.
Что делает Ghost in the Droid?
Это сервер протокола MCP, предоставляющий 62 инструмента для управления мобильными устройствами. Он позволяет агентам видеть дисплей смартфона, нажимать на элементы, свайпать и вводить данные.
Можно ли использовать эмуляторы вместо физических телефонов?
Да, виртуальные устройства поддерживаются. Для Android доступен пул контейнеров Docker с аппаратным ускорением KVM, а для iOS требуются стандартные симуляторы внутри macOS и Xcode.
