cross-dev-mcp

MCP de depuración en dispositivos reales multiplataforma para el desarrollo local de React Native. V1 admite dispositivos reales Android, iOS y HarmonyOS, priorizando el estado de conexión en tiempo real, capturas de pantalla/imágenes, registros, Doctor, Evidence y la devolución de contexto a Codex.

El diseño completo y la hoja de ruta se encuentran en docs/cross-dev-mcp-design-and-roadmap.md.

Arquitectura V1

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（仅真机）

Las capacidades del dispositivo se implementan a través de Providers; la capa de aplicación solo utiliza protocolos unificados como RuntimeTarget, RawFrame y NormalizedLogRecord. La inspección de DOM/elementos solo conserva el límite de la interfaz para el futuro y no forma parte del P0 actual.

Related MCP server: React Native Debug MCP

Desarrollo

pnpm install
pnpm dev

pnpm dev inicia simultáneamente el Daemon de dispositivos en http://127.0.0.1:4110 y la página de desarrollo Vue/Vite en http://127.0.0.1:5173. El frontend de MCP se divide en dos modos:

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

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

Verificación habitual:

pnpm typecheck
pnpm test
pnpm build

La dirección predeterminada del Daemon es http://127.0.0.1:4110. El Dashboard se puede abrir de forma independiente y también se abre en Hosts compatibles con MCP Apps mediante la herramienta MCP mobile_open_dashboard.

Si necesita demostrar la UI sin un dispositivo real, puede usar temporalmente CROSS_DEV_FAKE=1 pnpm dev:daemon; el inicio de producción/MCP no registra Fake Provider de forma predeterminada.

Añadir a Codex

En la máquina actual puede registrar directamente el MCP stdio:

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

El registro anterior se utiliza para la depuración local y hará que la aplicación MCP de Codex cargue directamente el código fuente en vivo de Vite. Para uso en producción, cambie mcp:dev al final por mcp. Después de reiniciar o actualizar la lista de MCP de Codex, puede llamar a mobile_open_dashboard para abrir el panel de trabajo. Si el proyecto se mueve a otro directorio, reemplace también la ruta absoluta en el comando.

Las responsabilidades, API, principios de plataforma y comandos de verificación de cada subpaquete se encuentran en el packages/*/README.md correspondiente; todos los métodos públicos y de implementación clave utilizan JSDoc en chino.

De forma predeterminada solo se escucha en 127.0.0.1. Las operaciones de escritura en el dispositivo, firma, instalación, túneles y elevación de privilegios no se ejecutan sin confirmación.