Metro MCP

Metro MCP — MCP-сервер сообщества (автор — steve228uk). Отладка и автоматизация React Native и Expo через Metro. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
steve228uk
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Выполняет JavaScript в приложении, управляет симулятором и устройством, читает файлы песочницы и сетевой трафик приложения.

Настройка клиентов

codex
{
    "code": "[mcp_servers.metro-mcp]\ncommand = \"npx\"\nargs = [\"-y\", \"metro-mcp\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "verified": "docs"
}

Что умеет

metro-mcp — MCP-сервер на плагинах для отладки, инспекции и автоматизации приложений React Native во время работы. Он подключается к сборщику Metro через Chrome DevTools Protocol, и для большинства функций код приложения менять не нужно. Работает с Expo, «голым» React Native и любым проектом на Metro и Hermes.

Как работает: находит Metro сканированием портов (8081, 8082, 19000–19002), подключается к движку Hermes по CDP, собирает в буферы логи консоли, сетевые запросы и ошибки и отдаёт всё это как инструменты, ресурсы и промпты MCP.

Плагины (главное):

  • console, network, errors — логи с фильтрами, сетевые запросы с телами ответов и статистикой, исключения и ошибки бандла.
  • evaluate — выполнение JavaScript в среде приложения.
  • redux, components, navigation, storage — состояние Redux и отправка действий, дерево компонентов React, состояние React Navigation и Expo Router, чтение AsyncStorage.
  • simulator, ui-interact, deeplink, permissions — управление симулятором iOS и устройством Android, нажатия, свайпы и ввод текста, проверка диплинков и разрешений.
  • profiler — профилирование CPU, выборка кучи и отслеживание рендеров.
  • test-recorder — запись действий и генерация тестов Appium (WebdriverIO), Maestro YAML или Detox.
  • filesystem — просмотр и чтение файлов в песочнице приложения (Documents, кэши, базы SQLite).
  • accessibility — аудит доступности.

Chrome DevTools одновременно с MCP. Hermes допускает только одно подключение отладчика. Встроенный CDP-прокси разделяет его, а инструмент open_devtools открывает DevTools через прокси. Клавиша «j» в Metro или пункт «Open Debugger» отключат MCP.

Несколько агентов сразу. Установки через stdio запускают или переиспользуют общий локальный демон для одного проекта, поэтому Codex, Claude Code, Cursor и другие клиенты видят одно и то же приложение и одни и те же логи.

Кому подойдёт

  • Разработчикам React Native и Expo, которые хотят отлаживать приложение через агента.
  • Тестировщикам, которым нужны автотесты по записанным сценариям.

Похожие серверы — в категории разработка.

Установка

Нужны Node.js 18+ или Bun 1.0+. Для iOS — Xcode 14+ с симулятором, для Android — Android SDK с adb в PATH. Для некоторых операций iOS нужен IDB (brew install idb-companion). Поддерживаются React Native 0.70+ с Hermes и Expo SDK 49+.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add metro-mcp -- npx -y metro-mcp
# or with Bun
claude mcp add metro-mcp -- bunx metro-mcp

Codex хранит серверы в ~/.codex/config.toml, есть и команда codex mcp add. OpenCode: opencode.json в проекте или ~/.config/opencode/opencode.json. Если Metro работает на нестандартном порту, добавьте --port 19000. Можно запустить и общий HTTP-сервер: npx -y metro-mcp serve --mcp-port 8765.

Проверка

Запустите приложение в Metro и попросите агента показать последние логи консоли.

Примеры задач

Напиши тест Appium для оформления заказа гостем: начни с кнопки Start Shopping и закончи на экране корзины.
Покажи упавшие сетевые запросы за последнюю минуту и тело ответа.

Риски

  • Выполнение кода в приложении. Агент выполняет JavaScript в среде приложения, отправляет действия Redux и управляет симулятором.
  • Доступ к данным приложения. Сервер читает файлы песочницы, AsyncStorage и тела сетевых ответов — там могут быть токены и личные данные.
  • Файлы. setup_statusline записывает скрипт в ~/.claude/metro-mcp-statusline.sh.

Частые вопросы

Нужно ли менять код приложения?

Для основных функций нет. Для своих команд и состояния есть необязательный объект __METRO_BRIDGE__ в режиме разработки.

Работает ли с реальными устройствами?

Да, с симулятором iOS, эмулятором Android и физическими устройствами по USB.

Можно ли добавить свои инструменты?

Да, сервер расширяется плагинами.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

browser-use

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники