# replicant-mcp

MCP-сервер управляет Android-проектом через ИИ: собирает APK, запускает эмулятор, проверяет интерфейс и разбирает логи.

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

## Что делает

replicant-mcp подключает Android-среду к ИИ-ассистенту через MCP. Он умеет собирать APK и bundle, запускать unit- и instrumented-тесты, показывать модули и варианты сборки, а также сравнивать результаты с базовой версией.

Сервер управляет эмуляторами и подключёнными устройствами: создаёт, запускает, останавливает и очищает их, работает со snapshot, устанавливает и удаляет приложения, очищает данные и запускает нужный пакет. Для UI он использует дерево доступности, ищет элементы по тексту и близости, выполняет нажатия, вводит текст и делает скриншоты.

Фильтрация logcat идёт по пакету, тегу, уровню и времени; есть диагностика через `replicant doctor` и настраиваемое структурированное логирование. Для работы нужны Node.js 18+, Android SDK с `adb` и `emulator` в `PATH`, а для сборки проекта — `gradlew`. Без этих компонентов Android-сценарии не запустятся.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- собрать APK или bundle проекта
- запустить unit- и instrumented-тесты
- установить приложение на эмулятор
- найти элементы интерфейса и нажать их
- отфильтровать logcat по приложению

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

## Похожие
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 9946
- [mobilerun](https://affpapa.org/nevibecode/mcp/mobilerun.md) — MCP-сервер · ★ 9751
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6505
- [ShipSwift](https://affpapa.org/nevibecode/mcp/shipswift.md) — MCP-сервер · ★ 3244
- [agent-device](https://affpapa.org/nevibecode/mcp/agent-device.md) — MCP-сервер · ★ 5149

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