Metro MCP — MCP-сервер для Claude Code: что делает и как установить
Подключает ИИ-ассистента к запущенному бандлеру Metro через Chrome DevTools Protocol. Позволяет отлаживать приложения на Expo и React Native прямо в чате.
claude mcp add metro-mcp -- npx -y metro-mcpЧто делает Metro MCP
Сервер обнаруживает Metro через опрос портов 8081, 8082 или диапазона 19000–19002 и связывается с движком Hermes по протоколу CDP. Большинству возможностей не требуются изменения в исходном коде приложения. Ассистент сразу получает поток логов консоли, сетевые вызовы, иерархию компонентов React и сбои сборки пакетов.
Набор плагинов позволяет запускать произвольный JavaScript в рантайме приложения, просматривать записи в AsyncStorage, проверять навигацию и состояние Redux. Инструменты поддерживают автоматизацию действий на симуляторах iOS и эмуляторах Android: тапы, свайпы, выдачу разрешений и вызов диплинков. Несколько ИИ-клиентов могут работать одновременно через общий фоновый демон.
Для запуска нужен Node.js 18+ либо Bun 1.0+. Для взаимодействия с симуляторами iOS требуется установленный Xcode 14+, а для Android — утилита adb в переменной PATH. Без запущенного сборщика Metro с движком Hermes сервер не сможет подключиться к рантайму.
Какие задачи решает
- читать сетевые запросы и ответы бандлера Metro
- перехватывать ошибки рантайма и логи консоли Hermes
- управлять симулятором iOS и эмулятором Android через агента
- инспектировать состояние Redux и React Navigation в реальном времени
Примеры запросов агенту
- Покажи последние ошибки из консоли приложения в Metro
- Проверь текущее состояние Redux и вызови экшен сброса авторизации
- Отправь диплинк
myapp://profile/settingsв симулятор iOS
Как установить Metro MCP
Командой платформы
claude mcp add metro-mcp -- npx -y metro-mcpКомандой платформы
codex mcp add metro-mcp -- npx -y metro-mcpФайл настроек
{
"mcpServers": {
"metro-mcp": {
"command": "npx",
"args": [
"-y",
"metro-mcp"
]
}
}
}Файл настроек
{
"servers": {
"metro-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"metro-mcp"
]
}
}
}Командой платформы
gemini mcp add metro-mcp npx -y metro-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Metro MCP
Как установить Metro MCP в Claude Code?
Выполните в терминале команду: claude mcp add metro-mcp -- npx -y metro-mcp. Если в проекте используется среда Bun, укажите команду bunx metro-mcp.
Что делает Metro MCP?
Сервер связывает интерфейс помощника с отладочной сессией Metro и Hermes. Это даёт модели возможность проверять логи, исследовать компоненты React, выполнять код и автоматизировать действия на симуляторах.
Какие системные утилиты нужны для работы с эмуляторами?
Для iOS необходим Xcode 14+ с утилитой xcrun simctl, а для Android — наличие adb в системном пути PATH. Для отдельных операций на iOS может потребоваться пакет idb-companion.
