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

Related MCP server: android-adb-mcp
Почему replicant-mcp?
Без replicant-mcp | С replicant-mcp |
"Запусти | "Собери и запусти приложение" |
Копирование и вставка вывода logcat, потеря контекста | ИИ читает отфильтрованные логи напрямую |
Скриншот → описание UI → угадывание координат | ИИ видит дерево доступности, нажимает на элементы по тексту |
5000 токенов необработанного вывода Gradle | Резюме на 50 токенов + детали по запросу |
Возможности
Категория | Функционал |
Сборка и тестирование | Сборка APK/бандлов, запуск модульных и инструментальных тестов, список модулей/вариантов/задач, тестирование обнаружения регрессий со сравнением базовых показателей |
Эмулятор | Создание, запуск, остановка, очистка эмуляторов; сохранение/загрузка/удаление снимков (snapshots) |
Управление устройством | Список подключенных устройств, выбор активного устройства, запрос свойств устройства |
Управление приложениями | Установка, удаление, запуск, остановка приложений; очистка данных приложений |
Анализ логов | Фильтрация logcat по пакету, тегу, уровню, времени |
Автоматизация UI | Поиск элементов на основе доступности, поиск по пространственной близости, нажатия, ввод текста, скриншоты |
Диагностика | Проверка работоспособности среды через |
Скоро появится
Пользовательские команды сборки (переопределения для конкретных проектов, автоопределение gradlew)
Захват видео (запуск/остановка записи, захват на основе длительности)
Быстрый старт
Предварительные требования
Node.js 18+
Android SDK с
adbиemulatorв вашем PATHAndroid-проект с
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-mcpCursor
Добавьте в ~/.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 инструментов и процесс устаревания | |
Модель безопасности adb-shell, черный список команд, границы угроз | |
Протестированные версии ОС, Node.js, Android SDK и эмуляторов | |
Пробелы в доступности, тайм-ауты, фокус на одном устройстве и многое другое | |
Содержимое директории | |
Распространенные проблемы и их решения | |
История версий | |
Процесс сообщения об уязвимостях | |
Как сообщать об ошибках и задавать вопросы | |
Настройка среды разработки и руководства |
Участие в разработке
См. CONTRIBUTING.md для настройки среды разработки и руководств.
Благодарности
Вдохновлено xc-mcp для iOS
Построено на Model Context Protocol
Лицензия
Есть вопросы? Откройте issue
Available Tools
14 toolsadb-appCDestructive
Manage applications.
Inputs: operation (required), apkPath, packageName, limit, +2 more.
adb-deviceC
Manage device connections.
Inputs: operation (required), deviceId.
adb-logcatCRead-onlyIdempotent
Read device logs. Returns summary with logId.
Inputs: lines (required), package, tags, level, +2 more.
adb-shellCDestructive
Execute shell commands with safety guards.
Inputs: command (required), timeout, maxChars, summaryOnly, +1 more.
cacheDDestructive
Manage the cache. See rtfm for details.
Inputs: operation (required), key, config.
emulator-deviceCDestructive
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-detailsCRead-onlyIdempotent
Fetch full output for a previous build/test by ID.
Inputs: id (required), detailType (required), maxChars, summaryOnly, +1 more.
gradle-listBRead-onlyIdempotent
Introspect project structure.
Inputs: operation (required), module.
gradle-testADestructive
Run tests. Returns summary with testId. With baseline, auto-detects regressions.
Inputs: operation (required), module, filter, taskName.
rtfmARead-onlyIdempotent
Get documentation. Pass category ('build'|'adb'|'emulator'|'ui'|'cache'|'index') or tool (tool name like 'ui-query').
Inputs: category, tool.
ui-actionADestructive
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-queryCRead-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
Scored across 14 tools
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.
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.
14 tools is well-scoped for an Android development/testing MCP, covering ADB, Gradle, emulators, UI, cache, and documentation without being overwhelming.
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
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceAn 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 npm3MIT
- FlicenseAqualityDmaintenanceAn MCP server designed for Android development, enabling AI assistants to directly control Android devices for screenshots, UI analysis, app management, and more.19-
- AlicenseBqualityCmaintenanceA 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.907MIT