Skip to main content
Glama

replicant-mcp

Позвольте ИИ собирать, тестировать и отлаживать ваши Android-приложения.

CI npm Node.js License: MIT Ask DeepWiki replicant-mcp MCP server

replicant-mcp — это сервер Model Context Protocol, который дает ИИ-ассистентам, таким как Claude, возможность взаимодействовать с вашей средой разработки Android. Собирайте APK, запускайте эмуляторы, устанавливайте приложения, перемещайтесь по интерфейсу и отлаживайте сбои — и все это в ходе естественного диалога.


Демонстрация

replicant-mcp demo


Related MCP server: android-adb-mcp

Почему replicant-mcp?

Без replicant-mcp

С replicant-mcp

"Запусти ./gradlew assembleDebug, затем adb install, затем adb shell am start..."

"Собери и запусти приложение"

Копирование и вставка вывода logcat, потеря контекста

ИИ читает отфильтрованные логи напрямую

Скриншот → описание UI → угадывание координат

ИИ видит дерево доступности, нажимает на элементы по тексту

5000 токенов необработанного вывода Gradle

Резюме на 50 токенов + детали по запросу


Возможности

Категория

Функционал

Сборка и тестирование

Сборка APK/бандлов, запуск модульных и инструментальных тестов, список модулей/вариантов/задач, тестирование обнаружения регрессий со сравнением базовых показателей

Эмулятор

Создание, запуск, остановка, очистка эмуляторов; сохранение/загрузка/удаление снимков (snapshots)

Управление устройством

Список подключенных устройств, выбор активного устройства, запрос свойств устройства

Управление приложениями

Установка, удаление, запуск, остановка приложений; очистка данных приложений

Анализ логов

Фильтрация logcat по пакету, тегу, уровню, времени

Автоматизация UI

Поиск элементов на основе доступности, поиск по пространственной близости, нажатия, ввод текста, скриншоты

Диагностика

Проверка работоспособности среды через replicant doctor; структурированное логирование с настраиваемым уровнем и форматом


Скоро появится

  • Пользовательские команды сборки (переопределения для конкретных проектов, автоопределение gradlew)

  • Захват видео (запуск/остановка записи, захват на основе длительности)


Быстрый старт

Предварительные требования

  • Node.js 18+

  • Android SDK с adb и emulator в вашем PATH

  • Android-проект с gradlew (для инструментов сборки)

node --version      # Should be 18+
adb --version       # Should show Android Debug Bridge version
emulator -version   # Should show Android emulator version

Установка

npm install -g replicant-mcp

После установки запустите встроенную диагностику, чтобы проверить вашу среду:

replicant doctor

Обновление

npm update -g replicant-mcp

Настройка

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

Claude Code

claude mcp add replicant -- npx -y replicant-mcp

Cursor

Добавьте в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (проект):

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

OpenAI Codex CLI

Добавьте в ~/.codex/config.toml:

[mcp_servers.replicant]
command = "npx"
args = ["-y", "replicant-mcp"]

Или через CLI:

codex mcp add replicant -- npx -y replicant-mcp

Примечание: Убедитесь, что adb и emulator находятся в вашем PATH, или установите переменную окружения ANDROID_HOME. В macOS: ~/Library/Android/sdk, в Linux: ~/Android/Sdk.


Пример

You: "I just changed the checkout flow. Build the app, go through checkout
      with a test product, and make sure the confirmation screen shows up."

Claude: [Builds debug APK, installs on emulator, launches app]
        [Taps "Electronics" category → "Wireless Headphones" → "Add to Cart"]
        [Navigates to cart, taps "Checkout"]
        [Fills shipping form, taps "Place Order"]

        Confirmation screen is showing:
        - Order #38291
        - "Wireless Headphones" × 1
        - Total: $79.99
        - Estimated delivery: Jan 30

        The flow works. Want me to test the edge cases—empty cart,
        invalid address, payment failure?

Проектирование

replicant-mcp использует прогрессивное раскрытие информации (сначала сводки, затем детали по запросу), чтобы минимизировать использование токенов, а также автоматизацию UI на основе доступности для более быстрого, дешевого и надежного взаимодействия, чем подходы на основе скриншотов. Подробности см. в docs/architecture.md.


Дополнительная информация

  • Конфигурация: Установите REPLICANT_CONFIG для расширенных опций. См. docs/configuration.md.

  • Логирование: Установите REPLICANT_LOG_LEVEL (error, warn, info, debug) и REPLICANT_LOG_FORMAT (json для структурированного вывода), чтобы управлять логированием сервера. Логи записываются в stderr.

  • Устранение неполадок: Распространенные проблемы и их решения в docs/troubleshooting.md.

  • Документация по инструментам: Попросите Claude вызвать rtfm с категорией, например "build", "adb", "emulator" или "ui".


Документация

Документ

Описание

Архитектура

Обзор дизайна и паттерн прогрессивного раскрытия

Конфигурация

Справочник по файлу конфигурации, переменным окружения, настройке Gradle

Стабильность API

Политика версионирования API инструментов и процесс устаревания

Модель безопасности

Модель безопасности adb-shell, черный список команд, границы угроз

Матрица поддержки

Протестированные версии ОС, Node.js, Android SDK и эмуляторов

Известные ограничения

Пробелы в доступности, тайм-ауты, фокус на одном устройстве и многое другое

Артефакты

Содержимое директории .replicant/ и вопросы конфиденциальности

Устранение неполадок

Распространенные проблемы и их решения

Журнал изменений

История версий

Политика безопасности

Процесс сообщения об уязвимостях

Поддержка / Получение помощи

Как сообщать об ошибках и задавать вопросы

Участие в разработке

Настройка среды разработки и руководства


Участие в разработке

См. CONTRIBUTING.md для настройки среды разработки и руководств.


Благодарности


Лицензия

MIT


Есть вопросы? Откройте issue

Available Tools

14 tools
adb-appC
Destructive

Manage applications.

Inputs: operation (required), apkPath, packageName, limit, +2 more.

adb-deviceC

Manage device connections.

Inputs: operation (required), deviceId.

adb-logcatC
Read-onlyIdempotent

Read device logs. Returns summary with logId.

Inputs: lines (required), package, tags, level, +2 more.

adb-shellC
Destructive

Execute shell commands with safety guards.

Inputs: command (required), timeout, maxChars, summaryOnly, +1 more.

cacheD
Destructive

Manage the cache. See rtfm for details.

Inputs: operation (required), key, config.

emulator-deviceC
Destructive

Manage Android emulators.

Inputs: operation (required), avdName, device, systemImage, +2 more.

gradle-buildD

Build. Returns summary with buildId.

Inputs: operation (required), module, flavor.

gradle-get-detailsC
Read-onlyIdempotent

Fetch full output for a previous build/test by ID.

Inputs: id (required), detailType (required), maxChars, summaryOnly, +1 more.

gradle-listB
Read-onlyIdempotent

Introspect project structure.

Inputs: operation (required), module.

gradle-testA
Destructive

Run tests. Returns summary with testId. With baseline, auto-detects regressions.

Inputs: operation (required), module, filter, taskName.

rtfmA
Read-onlyIdempotent

Get documentation. Pass category ('build'|'adb'|'emulator'|'ui'|'cache'|'index') or tool (tool name like 'ui-query').

Inputs: category, tool.

ui-actionA
Destructive

Interact with app UI: tap, input, scroll. Use selector or coords.

Inputs: operation (required), x, y, elementIndex, +5 more.

ui-captureC

Capture screenshots or visual snapshots.

Inputs: operation (required), localPath, inline, maxDimension, +1 more.

ui-queryC
Read-onlyIdempotent

Query app UI. Accessibility-first.

Inputs: operation (required), selector, debug, maxTier, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: adb-* for device management, gradle-* for build/test, ui-* for UI interaction, and separate tools for cache, docs, and emulators. No functional overlap.

    Naming Consistency4/5

    Names consistently use domain prefixes (adb-, gradle-, ui-), but gradle-get-details introduces a hyphenated verb-noun while others use single verbs or nouns, a minor inconsistency.

    Tool Count5/5

    14 tools is well-scoped for an Android development/testing MCP, covering ADB, Gradle, emulators, UI, cache, and documentation without being overwhelming.

    Completeness4/5

    Covers essential Android development operations (device management, build/test, UI interaction). Missing some niche ADB commands (e.g., port forwarding) but core workflows are present.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A powerful MCP server that provides comprehensive Android device automation capabilities through ADB, enabling AI agents to interact with Android devices for testing, automation, and device control tasks.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that wraps Android ADB functionality into AI assistant tools, enabling device management, shell execution, file operations, app management, media capture, and log analysis via natural language.
      23 npm
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A comprehensive MCP server for Android Debug Bridge, enabling AI agents to control Android devices through structured tools like launching apps, UI automation, file operations, and log capture.
      90
      7
      MIT