# mobile-mcp

Подключает управление мобильными устройствами на iOS и Android к ИИ-агенту. Пригодится для запуска тестов, снятия скриншотов и автоматизации сценариев в приложениях.

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

## Что делает

Сервер переводит действия ассистента в команды для платформ iOS и Android. Он взаимодействует с интерфейсом через дерево доступности, поэтому модели не нужно тратить лишние токены на распознавание каждого шага по картинке. Если элемент нестандартный, инструмент переключается на клики по координатам со скриншота.

Инструментарий позволяет ставить пакеты `.apk` или `.ipa`, запускать и закрывать приложения, менять ориентацию экрана и подменять координаты GPS. Работать можно с локальными симуляторами, подключёнными по USB телефонами или облачными инстансами.

Локальное окружение требует предустановленных системных утилит. Для симуляторов iOS нужен Xcode с `xcrun simctl`, а для Android понадобятся Android SDK и `adb`. Без них сервер не сможет управлять локальными устройствами.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mobile-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@mobilenext/mobile-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mobile-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mobilenext/mobile-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp
```

## Когда брать
- запустить сценарии тестирования на симуляторах iOS и эмуляторах Android
- установить сборку приложения из файла `.apk` или `.ipa` на устройство
- прочитать структуру элементов экрана через дерево доступности
- передать координаты кликов и жестов по скриншоту

## Примеры запросов агенту
- Найди запущенный эмулятор Android и открой на нём приложение по имени пакета.
- Сделай скриншот экрана телефона и перечисли координаты кнопок входа.
- Поменяй ориентацию экрана на альбомную и установи координаты GPS.

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