cross-dev-mcp

Кроссплатформенный MCP для отладки на реальных устройствах при локальной разработке React Native. V1 поддерживает реальные устройства Android, iOS и HarmonyOS, в первую очередь предоставляя статус подключения в реальном времени, скриншоты/изображения, логи, Doctor, Evidence и обратную передачу контекста Codex.

Полный дизайн и дорожная карта — в docs/cross-dev-mcp-design-and-roadmap.md.

Архитектура 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（仅真机）

Возможности устройств реализуются через Provider, а прикладной уровень использует только унифицированные протоколы, такие как RuntimeTarget, RawFrame, NormalizedLogRecord. Проверка DOM/элементов сохраняется только как граница будущего интерфейса и не входит в текущий P0.

Related MCP server: React Native Debug MCP

Разработка

pnpm install
pnpm dev

pnpm dev одновременно запускает Daemon устройств на http://127.0.0.1:4110 и страницу разработки Vue/Vite на http://127.0.0.1:5173. Фронтенд MCP работает в двух режимах:

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

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

Часто используемые проверки:

pnpm typecheck
pnpm test
pnpm build

Адрес Daemon по умолчанию — http://127.0.0.1:4110. Dashboard можно открыть отдельно, а также через MCP tool mobile_open_dashboard в Host, поддерживающем MCP Apps.

Если нужно продемонстрировать UI без реального устройства, можно временно использовать CROSS_DEV_FAKE=1 pnpm dev:daemon; при запуске в production/MCP Fake Provider по умолчанию не регистрируется.

Добавление в Codex

На текущей машине можно напрямую зарегистрировать stdio MCP:

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

Указанная выше регистрация предназначена для локальной отладки и позволяет Codex MCP App загружать исходный код Vite в реальном времени. При официальном использовании замените mcp:dev в конце на mcp. После перезапуска или обновления списка MCP в Codex можно вызвать mobile_open_dashboard, чтобы открыть рабочую панель. Если проект перемещён в другую директорию, синхронно замените абсолютный путь в команде.

Обязанности каждого подпакета, API, принципы платформ и команды проверки описаны в соответствующих packages/*/README.md; все публичные и ключевые методы реализации используют JSDoc на китайском языке.

По умолчанию прослушивается только 127.0.0.1. Операции записи на устройство, подпись, установка, туннелирование и повышение привилегий не выполняются без подтверждения.