MCP Mobile Server — KI-gestützte mobile Entwicklung für Android, iOS und Flutter

36 Tools für die Automatisierung der mobilen Entwicklung, sofort einsatzbereit in Claude Desktop und jedem MCP-kompatiblen KI-Client.

von Cristiano Arêdes

Was ist das?

MCP Mobile Server ist ein Model Context Protocol-Server, der KI-Assistenten direkten, strukturierten Zugriff auf Ihre Toolchain für die mobile Entwicklung gewährt. Er verbindet Claude Desktop (und andere MCP-Clients) mit Flutter-, Android SDK- und iOS/Xcode-Workflows durch 36 typisierte Tools und 10 übergeordnete "Super-Tools", die vollständige, mehrstufige Workflows orchestrieren.

Anstatt zwischen Terminals und Dokumentationen zu wechseln, beschreiben Sie in natürlicher Sprache, was Sie tun möchten, und der Server führt die richtigen Befehle aus – inklusive integrierter Validierung, Fehlerbehandlung und Fallback-Strategien.

Unterstützte Plattformen: Android · iOS · Flutter · macOS · Linux · Windows (teilweise)

Related MCP server: Specter MCP

Funktionen

Super-Tools — vollständige Workflows in einem Aufruf

Integrierte Sicherheit

• Alle Shell-Befehle werden vor der Ausführung gegen eine Positivliste (Allowlist) validiert

• Erkennung gefährlicher Muster blockiert Injektionsversuche

• Schutz vor Pfad-Traversal bei allen Dateiargumenten

• Laufzeit-Eingabevalidierung via Zod

• Konfigurierbare Timeouts für lang laufende Prozesse

Anforderungen

Sie benötigen nur die SDKs für die Plattformen, mit denen Sie arbeiten. Der Server startet und stellt Tools auch dann bereit, wenn einige SDKs fehlen.

Installation

Option 1 — Ausführen mit npx (keine Installation erforderlich)

npx @cristianoaredes/mcp-mobile-server

Option 2 — Global installieren

npm install -g @cristianoaredes/mcp-mobile-server
mcp-mobile-server

Option 3 — Aus dem Quellcode bauen

git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install
npm run build
npm start

Claude Desktop Einrichtung

Fügen Sie den Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mobile-dev": {
      "command": "npx",
      "args": ["@cristianoaredes/mcp-mobile-server"]
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu. Die 36 Tools für die mobile Entwicklung erscheinen automatisch.

Anwendungsbeispiele

Überprüfen Sie Ihre Umgebung

Use the health_check tool to verify the mobile development server is working

Run flutter_doctor to check my Flutter setup

Arbeiten mit Geräten

List all connected Android devices and iOS simulators

Start a Flutter development session with hot reload on the best available device

Bauen und Testen

Run the full test suite for my Flutter project at /path/to/project

Build release versions for Android and iOS

Build-Probleme beheben

My Flutter app won't build. Use flutter_fix_common_issues to diagnose and fix it.

Validieren Sie die Installation über die Befehlszeile

# After building from source:
npm run mcp:validate

# Expected output:
# ✅ Server configuration is valid
# ✅ 36 tools registered

Projektstruktur

src/
  server.ts          # MCP server entry point
  tools/
    android.ts       # Android SDK tools
    ios.ts           # iOS / Xcode / Simulator tools
    flutter.ts       # Flutter SDK tools
    super-tools.ts   # High-level workflow automation
    setup-tools.ts   # Environment setup tools
  utils/
    process.ts       # Process execution and tracking
    security.ts      # Command validation and sandboxing
    fallbacks.ts     # Fallback strategies (ADB → native-run, etc.)
    tool-categories.ts # Tool registry

Der Server kommuniziert über stdio mittels JSON-RPC 2.0, dem Standard-MCP-Transport.

Mitwirken

# Clone and install
git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install

# Run in development mode (watch)
npm run dev

# Run tests
npm test

# Run linter and full CI check
npm run ci

Siehe CONTRIBUTING.md für Richtlinien und docs/ für die vollständige Dokumentation.

Dokumentation

Fehlerbehebung

Flutter nicht gefunden

# Run the automated setup tool
# In Claude Desktop: "Use flutter_setup_environment to install Flutter"

Android SDK nicht konfiguriert

# In Claude Desktop: "Use android_sdk_setup to configure Android"

Keine Geräte verfügbar

# List what's available
# "Use android_list_emulators and ios_list_simulators to see available devices"

# Or start a new one
# "Use android_start_emulator to launch an Android emulator"

Claude Desktop erkennt den Server nicht

1. Überprüfen Sie, ob der Pfad zur Konfigurationsdatei für Ihr Betriebssystem korrekt ist

2. Prüfen Sie, ob das JSON gültig ist (keine nachgestellten Kommas)

3. Starten Sie Claude Desktop vollständig neu

4. Fragen Sie Claude: "Use health_check to verify the mobile server"

Lizenz

MIT — frei zu verwenden, zu ändern und zu verteilen.

Fehler melden · Funktion anfragen · Vollständige Dokumentation