Buoy MCP

Buoy MCP дает агенту читать работающее приложение на React Native или Flutter, нажимать на экран и смотреть сеть

693 ★ репозитория
Последний коммит 23 окт. 2026

Установка

Работает в: Claude Code
Cursor
VS Code
SourceCraft
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/buoy-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Нажимает на экран, вводит текст и управляет симулятором или телефоном, а в Pro меняет значения хранилища, состояние Redux и Zustand, время, геолокацию и разрешения приложения
Читает тела сетевых запросов и значения хранилища, где бывают токены и персональные данные
Команда init перезаписывает запись buoy в файлах настройки MCP и копирует скилл с заменой совпадающих файлов

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Buoy MCP подключает агента к приложению на React Native или Flutter, которое запущено на симуляторе или телефоне с панелью разработчика Buoy. Агент начинает с list_devices, видит подключенные устройства и доступные на них инструменты, затем читает события: сетевые запросы, смены состояния, переходы между экранами, записи в хранилище. Экраном агент управляет как человек. describe_screen читает, что показано, tap_element, native_tap, native_swipe и native_type нажимают, листают и вводят текст, а run_flow выполняет цепочку шагов за один вызов и может сохранить удачный сценарий в .buoy/flows. screenshot_component и screen_recording снимают кадры и видео, get_console читает логи, reload_app и navigate перезапускают приложение и переходят на нужный маршрут. Бесплатный аккаунт открывает базовые инструменты и Buoy Optimize с замерами fps, CPU, памяти и рывков. Pro добавляет состояние Zustand, Redux, Jotai и React Query, значения хранилища, тела запросов и их подмену, смену времени, геолокации и разрешений, а также причины медленных экранов. По субботам и воскресеньям бесплатный аккаунт получает все возможности Pro. Из того же пакета ставится Buoy Web: агент работает в собственных вкладках Chrome, и аккаунт для этого не нужен.

Для кого. Для мобильных разработчиков на React Native и Flutter, которые отлаживают и профилируют приложение вместе с Claude Code, Cursor и другими MCP-клиентами.

Подходит, если

Агент должен сам пройти экран на симуляторе, нажать кнопки и убедиться, что правка работает: describe_screen и run_flow
Баг сидит в сети: get_network_requests показывает список запросов с идентификаторами, а get_network_request читает один целиком
Приложение тормозит, и нужны замеры до и после правки через run_benchmark_batch и compare_reports
Надо проверить работу без сети или с задержкой через network_conditions (React Native, сборки для разработки)
Для отчета об ошибке нужны скриншот компонента или запись экрана

Не подходит, если

Приложение нативное на Swift или Kotlin: Buoy подключается пакетами внутри React Native или Flutter
Нужно разбирать релизную сборку: синхронизация в ней выключена, пока вы не включите ее сами
Вы не хотите заводить аккаунт на buoy.gg: для MCP нужен вход, даже на бесплатном тарифе
Нужны касания и снимки симулятора, а Xcode (iOS) или adb (Android) на машине нет: эти инструменты работают только с ними

Пример запроса к агенту

Запусти приложение на симуляторе, открой экран корзины, нажми «Оформить заказ» и покажи мне, какие сетевые запросы при этом ушли и чем они ответили

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения

BUOY_VERIFY: Включает напоминание проверить правку на устройстве, прежде чем считать ее готовой, в примере значение auto

Ограничения

Нужны Node.js 18 или новее и аккаунт Buoy: вход выполняет команда buoy login. Без входа сервер ищет ключ в env-файлах папки запуска.
Если агент вызывает инструмент, закрытый тарифом, он получает сообщение, что нужен Pro, и до приложения запрос не доходит.
Часть возможностей работает только в React Native, например network_conditions и состояние Redux.
В приложении на React Native нужен пакет @buoy-gg/external-sync и компонент FloatingDevTools, во Flutter компонент BuoyDevTools.
Конфигурация с npx и @latest при запуске редактора обращается к реестру npm. Если приватный реестр из .npmrc недоступен, init сам ставит закрепленную локальную копию.

Как отключить. Удалите запись buoy из .mcp.json, .cursor/mcp.json и .vscode/mcp.json, затем перезапустите редактор. Команда init копирует в проект скилл buoy-optimize, его папку тоже можно убрать. Из приложения панель Buoy убирают вместе с пакетом @buoy-gg/external-sync.

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

Как подключить Buoy MCP к Claude Code?

В папке приложения выполните npx --package=@buoy-gg/core buoy login, подтвердите вход в браузере и запустите npx -y @buoy-gg/mcp@latest init. Команда запишет сервер в .mcp.json. После перезапуска редактора попросите агента вызвать list_devices.

Что входит в бесплатный тариф Buoy MCP?

Чтение экрана, нажатия и ввод, run_flow, скриншоты и запись, логи консоли, список сетевых запросов без тел, сводка get_triage с названиями ключей хранилища и Buoy Optimize с замерами скорости. Состояние, значения хранилища, тела запросов и причины медленных экранов относятся к Pro, а по выходным доступны всем.

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

Да, для этого в пакете есть Buoy Web: команда npx -y @buoy-gg/mcp@latest init --web добавляет сервер buoy-web, затем ставится расширение для Chrome. Аккаунт не нужен. Агент работает только во вкладках, которые открыл сам, и не вводит пароли и номера карт.

Работает ли Buoy MCP с реальным телефоном?

Да. Для приложения на React Native Buoy берет адрес брокера из Metro, и телефон обычно находит его сам. Во Flutter в BuoyDevTools передают socketUrl вида http://<lan-ip>:42831. Касания и снимки с компьютера требуют Xcode для iOS или adb для Android.

Как обновить Buoy MCP?

Повторите npx -y @buoy-gg/mcp@latest init: запись сервера заменится, а файлы скилла buoy-optimize перезапишутся, поэтому свои правки в нем сначала сохраните. Сервер раз в сутки проверяет npm и добавляет в ответ list_devices строку о новой версии.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Argent

Дает агенту управление iOS-симуляторами, Android-эмуляторами, ТВ и Electron-приложениями: тапы, потоки, профилирование и отладка React Native

CLIШирокий доступ3,1 тыс.

Mobile MCP

MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты

MCP-серверШирокий доступ10,1 тыс.

Expo Skills

Выбор редакции

Официальные скиллы Expo для агентов: сборка, деплой, обновление и отладка приложений на Expo и EAS

ПлагинРасширенный доступ3,7 тыс.

appllama-skills

Два скилла для сборки мобильных экранов уровня топовых приложений: разбор чужих экранов через Appllama MCP и строгая планка нативной верстки на Expo и React Nat

СкиллРасширенный доступ3,5 тыс.

Flutter Agent Plugins

Официальный

Плагин команды Flutter для агентов: скиллы по Flutter и Dart, сервер Dart MCP и правило горячей перезагрузки для Claude Code, Cursor и Codex

ПлагинРасширенный доступ3,1 тыс.

serve-sim

Команда npx serve-sim выводит симулятор iOS в браузер и позволяет агенту нажимать, свайпать, вводить текст и подменять камеру

CLIРасширенный доступ2,9 тыс.

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
Buoy MCP (эта запись)	да	OAuth	693
agent-react-devtools	нет		252	CLI про дерево компонентов, props, state и профилирование рендеров в React, без касаний по экрану и без Flutter
Mobile MCP	нет	не нужна	10 095	управляет iOS и Android через дерево доступности и скриншоты, внутрь приложения за сетью и состоянием не заглядывает

Коротко о README

README пакета @buoy-gg/mcp открывается одной командой установки и пояснением, что бесплатный аккаунт дает базовые инструменты и Buoy Optimize, а Pro добавляет полный набор. Отдельный раздел посвящен Buoy Web, режиму для работы агента в Chrome без аккаунта. Остальные разделы показывают приемы: как читать экран через native_inspect с координатами в пунктах симулятора, как сравнить сохраненный PNG с живым экраном и как собрать многошаговый сценарий в run_flow. Подробное руководство вынесено на сайт buoy.gg и в документ docs/mcp.md в репозитории.

Бейдж для README

Сообщить о проблеме