replicant-mcp
replicant-mcp
Lassen Sie KI Ihre Android-Apps erstellen, testen und debuggen.
replicant-mcp ist ein Model Context Protocol-Server, der KI-Assistenten wie Claude die Möglichkeit gibt, mit Ihrer Android-Entwicklungsumgebung zu interagieren. Erstellen Sie APKs, starten Sie Emulatoren, installieren Sie Apps, navigieren Sie durch Benutzeroberflächen und debuggen Sie Abstürze – alles durch natürliche Konversation.
Demo

Related MCP server: android-adb-mcp
Warum replicant-mcp?
Ohne replicant-mcp | Mit replicant-mcp |
"Führe | "Erstelle und starte die App" |
Kopiere Logcat-Ausgabe, verliere Kontext | KI liest gefilterte Logs direkt |
Screenshot → beschreibe UI → rate Koordinaten | KI sieht Accessibility-Tree, tippt Elemente per Text an |
5.000 Token rohe Gradle-Ausgabe | 50-Token-Zusammenfassung + Details bei Bedarf |
Funktionen
Kategorie | Fähigkeiten |
Erstellen & Testen | Erstelle APKs/Bundles, führe Unit- und instrumentierte Tests aus, liste Module/Varianten/Tasks auf, teste Regressionserkennung mit Baseline-Vergleich |
Emulator | Erstelle, starte, stoppe, lösche Emulatoren; speichere/lade/lösche Snapshots |
Gerätesteuerung | Liste verbundene Geräte auf, wähle aktives Gerät aus, frage Geräteeigenschaften ab |
App-Verwaltung | Installiere, deinstalliere, starte, stoppe Apps; lösche App-Daten |
Log-Analyse | Filtere Logcat nach Paket, Tag, Level, Zeit |
UI-Automatisierung | Accessibility-basierte Elementfindung, räumliche Suche, Tippen, Texteingabe, Screenshots |
Diagnose | System-Gesundheitschecks via |
Demnächst verfügbar
Benutzerdefinierte Build-Befehle (projektspezifische Überschreibungen, automatische Erkennung von gradlew)
Videoaufnahme (Aufnahme starten/stoppen, dauerbasierte Aufnahme)
Schnellstart
Voraussetzungen
Node.js 18+
Android SDK mit
adbundemulatorin Ihrem PATHEin Android-Projekt mit
gradlew(für Build-Tools)
node --version # Should be 18+
adb --version # Should show Android Debug Bridge version
emulator -version # Should show Android emulator versionInstallation
npm install -g replicant-mcpFühren Sie nach der Installation die integrierte Diagnose aus, um Ihre Umgebung zu überprüfen:
replicant doctorAktualisierung
npm update -g replicant-mcpEinrichtung
Claude Desktop
Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %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
Hinzufügen zu ~/.cursor/mcp.json (global) oder .cursor/mcp.json (Projekt):
{
"mcpServers": {
"replicant": {
"command": "npx",
"args": ["-y", "replicant-mcp"]
}
}
}Windsurf
Hinzufügen zu ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"replicant": {
"command": "npx",
"args": ["-y", "replicant-mcp"]
}
}
}OpenAI Codex CLI
Hinzufügen zu ~/.codex/config.toml:
[mcp_servers.replicant]
command = "npx"
args = ["-y", "replicant-mcp"]Oder via CLI:
codex mcp add replicant -- npx -y replicant-mcpHinweis: Stellen Sie sicher, dass
adbundemulatorin Ihrem PATH enthalten sind, oder setzen Sie die UmgebungsvariableANDROID_HOME. Unter macOS:~/Library/Android/sdk, unter Linux:~/Android/Sdk.
Beispiel
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?Design
replicant-mcp verwendet progressive Offenlegung (Zusammenfassungen zuerst, Details bei Bedarf), um den Token-Verbrauch zu minimieren, sowie Accessibility-basierte UI-Automatisierung für schnellere, kostengünstigere und zuverlässigere Interaktionen als screenshot-basierte Ansätze. Siehe docs/architecture.md für Details.
Weitere Informationen
Konfiguration: Setzen Sie
REPLICANT_CONFIGfür erweiterte Optionen. Siehe docs/configuration.md.Protokollierung: Setzen Sie
REPLICANT_LOG_LEVEL(error,warn,info,debug) undREPLICANT_LOG_FORMAT(jsonfür strukturierte Ausgabe), um die Server-Protokollierung zu steuern. Logs werden in stderr geschrieben.Fehlerbehebung: Häufige Probleme und Lösungen in docs/troubleshooting.md.
Tool-Dokumentation: Bitten Sie Claude,
rtfmmit einer Kategorie wie "build", "adb", "emulator" oder "ui" aufzurufen.
Dokumentation
Dokument | Beschreibung |
Design-Übersicht und Muster der progressiven Offenlegung | |
Referenz der Konfigurationsdatei, Umgebungsvariablen, Gradle-Setup | |
Richtlinie zur Tool-API-Versionierung und Veraltungsprozess | |
adb-shell Sicherheitsmodell, Befehls-Denylist, Bedrohungsgrenzen | |
Getestete OS-, Node.js-, Android SDK- und Emulator-Versionen | |
Accessibility-Lücken, Timeouts, Fokus auf ein einzelnes Gerät und mehr | |
Inhalte des | |
Häufige Probleme und Lösungen | |
Versionsverlauf | |
Prozess zur Meldung von Schwachstellen | |
Wie man Fehler meldet und Fragen stellt | |
Entwicklungs-Setup und Richtlinien |
Mitwirken
Siehe CONTRIBUTING.md für Entwicklungs-Setup und Richtlinien.
Danksagungen
Inspiriert von xc-mcp für iOS
Aufgebaut auf dem Model Context Protocol
Lizenz
Fragen? Öffnen Sie ein 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.3MIT
- 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