cross-dev-mcp

Plattformübergreifendes MCP für die lokale React-Native-Entwicklung mit echten Geräten. V1 unterstützt echte Android-, iOS- und HarmonyOS-Geräte und bietet vorrangig Echtzeit-Verbindungsstatus, Screenshots/Bildschirmbilder, Logs, Doctor, Evidence und Codex-Kontext-Rückmeldung.

Das vollständige Design und die Roadmap finden Sie in docs/cross-dev-mcp-design-and-roadmap.md.

V1-Architektur

Codex / MCP Host
  ├─ stdio MCP tools
  └─ Vue 3 MCP App
          │ REST + WebSocket
       Hono Daemon
          │ unified TypeScript API
     CrossDevService
       ├─ Android: Tango + Google ADB Server（无 scrcpy）
       ├─ iOS: go-ios（仅真机）
       └─ HarmonyOS: 官方 HDC / UITest / HiLog（仅真机）

Gerätefunktionen werden über Provider implementiert; die Anwendungsebene verwendet nur einheitliche Protokolle wie RuntimeTarget, RawFrame und NormalizedLogRecord. Die DOM-/Elementprüfung behält nur die zukünftige Schnittstellengrenze bei und gehört nicht zum aktuellen P0.

Related MCP server: React Native Debug MCP

Entwicklung

pnpm install
pnpm dev

pnpm dev startet gleichzeitig den Geräte-Daemon unter http://127.0.0.1:4110 und die Vue/Vite-Entwicklungsseite unter http://127.0.0.1:5173. Das MCP-Frontend ist in zwei Modi verfügbar:

# 调试模式：从 Vite 加载实时源码并启用 HMR
pnpm mcp:dev

# 正式模式：读取 apps/dashboard/dist 构建产物
pnpm build
pnpm mcp

Häufige Verifizierung:

pnpm typecheck
pnpm test
pnpm build

Die Standardadresse des Daemons lautet http://127.0.0.1:4110. Das Dashboard kann eigenständig geöffnet werden und wird außerdem über das MCP-Tool mobile_open_dashboard in Hosts geöffnet, die MCP-Apps unterstützen.

Wenn Sie die UI ohne echtes Gerät demonstrieren möchten, können Sie vorübergehend CROSS_DEV_FAKE=1 pnpm dev:daemon verwenden; beim Produktions-/MCP-Start wird der Fake-Provider standardmäßig nicht registriert.

Zu Codex hinzufügen

Auf dem aktuellen Rechner kann stdio MCP direkt registriert werden:

codex mcp add cross-dev-mcp -- \
  pnpm --silent --dir /Users/didi/VscodeProjects/phone-dev-mcp mcp:dev

Die obige Registrierung dient der lokalen Fehlersuche und lässt die Codex-MCP-App den Vite-Echtzeit-Quellcode direkt laden. Ändern Sie für den offiziellen Einsatz mcp:dev am Ende in mcp. Nach einem Neustart oder einer Aktualisierung der Codex-MCP-Liste kann mobile_open_dashboard aufgerufen werden, um die Arbeitsumgebung zu öffnen. Wenn das Projekt in ein anderes Verzeichnis verschoben wird, ersetzen Sie bitte den absoluten Pfad im Befehl entsprechend.

Die Zuständigkeiten, APIs, Plattformprinzipien und Verifizierungsbefehle der einzelnen Unterpakete finden Sie in den entsprechenden packages/*/README.md; alle öffentlichen und wichtigen Implementierungsmethoden verwenden chinesische JSDoc-Kommentare.

Standardmäßig wird nur 127.0.0.1 überwacht. Schreiboperationen am Gerät, Signierung, Installation, Tunnel und Rechteerweiterung werden ohne Bestätigung nicht ausgeführt.