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-emulator-mcp

Почему replicant-mcp?

Возможности

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

• Пользовательские команды сборки (переопределения для конкретных проектов, автоопределение 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".

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

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

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

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

• Вдохновлено xc-mcp для iOS

• Построено на Model Context Protocol

Лицензия

MIT

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• adb-appC
• adb-deviceC
• adb-logcatC
• adb-shellC
• cacheD
• emulator-deviceC
• gradle-buildD
• gradle-get-detailsC