replicant-mcp

Lassen Sie KI Ihre Android-Apps erstellen, testen und debuggen.

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

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

👁 replicant-mcp demo

Related MCP server: android-emulator-mcp

Warum replicant-mcp?

Funktionen

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 adb und emulator in Ihrem PATH

• Ein 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 version

Installation

npm install -g replicant-mcp

Führen Sie nach der Installation die integrierte Diagnose aus, um Ihre Umgebung zu überprüfen:

replicant doctor

Aktualisierung

npm update -g replicant-mcp

Einrichtung

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

Cursor

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

Hinweis: Stellen Sie sicher, dass adb und emulator in Ihrem PATH enthalten sind, oder setzen Sie die Umgebungsvariable ANDROID_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_CONFIG für erweiterte Optionen. Siehe docs/configuration.md.

• Protokollierung: Setzen Sie REPLICANT_LOG_LEVEL (error, warn, info, debug) und REPLICANT_LOG_FORMAT (json fü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, rtfm mit einer Kategorie wie "build", "adb", "emulator" oder "ui" aufzurufen.

Dokumentation

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

MIT

Fragen? Öffnen Sie ein 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