# mobilerun

Даёт агенту доступ к реальному Android- или iOS-устройству: нажимать, свайпать, вводить текст и выполнять сценарии по описанию словами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 9751
- Автор: droidrun
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/droidrun/mobilerun
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/mobilerun

## Что делает

mobilerun — открытый фреймворк для управления телефонами через LLM-агентов. Агент получает мобильные инструменты: смотрит дерево UI, читает скриншоты, тапает, свайпает, печатает и планирует цепочки шагов. Результат возвращается через CLI или Python API.

Работает с Android через приложение Portal и `adb`, с iPhone — через `mobilerun-ios` по USB, с симулятором iOS — через iOS Portal. Провайдеры на выбор: OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter и OpenAI-совместимые. Для Anthropic нужен отдельный extra при установке.

Перед запуском понадобится Python `>=3.11,<3.14` — версия 3.14 пока не поддерживается. Для Android нужен установленный ADB и включённые «Параметры разработчика» с отладкой по USB. Ключ провайдера задаётся переменной окружения или через `mobilerun configure`.

## Требования
- Удалённый сервер: `https://api.mobilerun.ai/v1/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add mobilerun --url https://api.mobilerun.ai/v1/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mobilerun": {
            "url": "https://api.mobilerun.ai/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mobilerun": {
            "type": "http",
            "url": "https://api.mobilerun.ai/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mobilerun https://api.mobilerun.ai/v1/mcp
```

## Когда брать
- прогнать сценарий настройки по экранам реального телефона
- проверить, какое приложение открыто сейчас, по скриншоту
- найти контакт и отправить ему письмо без ручного ввода
- записать и повторять макрос по шагам
- отладить многошаговый сценарий с трассировкой выполнения

## Примеры запросов агенту
- Подключи mobilerun и открой настройки, включи тёмную тему
- Спроси у устройства, какое приложение сейчас открыто, с флагом --vision
- Найди контакт John и отправь ему письмо в режиме --reasoning

## Похожие
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6505

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md