tapflow MCP Server
MCP-сервер tapflow: агент управляет iOS-симуляторами и Android-эмуляторами на вашем Mac и воспроизводит сценарии для CI
- 1 975 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент нажимает, вводит текст, ставит и запускает приложения на устройствах вашей команды
- Токен с правом записи сборок открывает ретранслятор и загруженные в него сборки
- Скриншоты экранов и дерево интерфейса попадают в контекст модели, там могут быть персональные данные тестовых аккаунтов
Установка
- Работает в
Ручная установка
npm install -g @tapflowio/mcp-serverНужен работающий ретранслятор tapflow: `npm install -g tapflow`, затем `tapflow start`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент нажимает, вводит текст, ставит и запускает приложения на устройствах вашей команды
- Токен с правом записи сборок открывает ретранслятор и загруженные в него сборки
- Скриншоты экранов и дерево интерфейса попадают в контекст модели, там могут быть персональные данные тестовых аккаунтов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет `@tapflowio/mcp-server` отдает LLM-агентам iOS-симуляторы и Android-эмуляторы как инструменты. Он входит в tapflow, аналог Appetize и BrowserStack для мобильного QA, который вы разворачиваете у себя. Ретранслятор на вашем сервере связывает браузер команды с агентом на Mac, а агент управляет симуляторами и эмуляторами. Сервер дает 17 инструментов. Агент перечисляет устройства, подключается и запускает их, делает скриншоты, нажимает на экран и кнопки, листает, вводит текст, ставит и запускает приложения. Инструмент `query_ui_tree` возвращает дерево доступности с ролями, подписями и рамками, нормализованными от 0 до 1, поэтому агент нажимает по элементу, и угадывать координаты по картинке не нужно. `run_flow` воспроизводит YAML-сценарий формата `@tapflowio/flow-runner` без обращений к LLM: сценарий пишется один раз вместе с агентом и повторяется детерминированно. Инструменты `list_runs` и `get_run` читают записи запусков, оставленные `tapflow flow run`, с экраном, на котором остановился упавший сценарий. Так агент чинит сценарий для CI и проверяет его снова.
Для кого. Для мобильных разработчиков и QA-инженеров, у которых уже работает ретранслятор tapflow и которые хотят поручить Claude Code или Codex проверку приложений на симуляторах.
Подходит, если
- Агент должен установить сборку на симулятор, пройти экран регистрации и сделать скриншоты каждого шага
- Нужно один раз составить сценарий проверки вместе с агентом и затем гонять его в CI без расхода токенов
- Сценарий в CI упал, и агенту нужно открыть экран, на котором он остановился, и поправить шаги
- Нажатия должны идти по элементам дерева доступности, с ролью и подписью каждого
Не подходит, если
- Ретранслятор tapflow не развернут: MCP-серверу некуда подключаться
- Нужны настоящие телефоны: tapflow работает с симуляторами и эмуляторами, фермы устройств в нем нет
- Нужна интеграция с Appium или WebDriverAgent: разработчик исключил ее и поставляет собственный минимальный исполнитель сценариев
Пример запроса к агенту
Запусти iPhone-симулятор в tapflow, установи последнюю сборку, пройди регистрацию и сохрани скриншот каждого экранаMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
TAPFLOW_RELAY_URLобязательная- Адрес ретранслятора tapflow, например ws://localhost:4000
TAPFLOW_TOKENсекрет- Токен API-типа с правами просмотра и записи сборок; без него читается файл credentials.json
Ограничения
- Нужен работающий ретранслятор tapflow и агент на Mac. Для iOS требуются macOS 26 или 27, Xcode 26 или 27 и среда выполнения iOS Simulator.
- Проект на версии 0.x, между выпусками возможны несовместимые изменения.
- Токен доступа должен быть API-типа с правами просмотра и записи сборок. Без него сервер читает файл `~/.config/tapflow/credentials.json`.
- Ретранслятор запускается на Linux и macOS, агент симуляторов работает только на Mac.
Как отключить. Удалите запись tapflow из `.mcp.json` или из MCP-конфигурации вашего агента. Пакет снимает команда `npm uninstall -g @tapflowio/mcp-server`. Токен отзовите в панели tapflow.
Частые вопросы
Как подключить tapflow к Claude Code?
Выполните `npm install -g @tapflowio/mcp-server`, затем добавьте в `.mcp.json` сервер с командой `tapflow-mcp` и переменными `TAPFLOW_RELAY_URL` и `TAPFLOW_TOKEN`. Ретранслятор запускает `tapflow start`.
Какие инструменты есть в MCP-сервере tapflow?
Среди них `list_devices`, `connect_device`, `boot_device`, `screenshot`, `query_ui_tree`, `tap`, `swipe`, `type_text`, `install_app`, `launch_app` и `run_flow`. Всего 17, полный список в README пакета.
Как агенту не тратить токены на повторные проверки?
Составьте сценарий вместе с агентом и сохраните его в формате `@tapflowio/flow-runner`. Инструмент `run_flow` повторяет его без обращений к модели.
Нужен ли токен для MCP-сервера?
Да, токен API-типа с правами просмотра и записи сборок. Если не задать `TAPFLOW_TOKEN`, сервер читает `~/.config/tapflow/credentials.json` и перечитывает его, когда ретранслятор отклоняет токен.
Работает ли это на Linux или Windows?
Частично: ретранслятор работает на Linux, а агента симуляторов нужно запускать на Mac. Windows в списке платформ нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
BrowserStack MCP Server — тесты на реальных устройствах
BrowserStack MCP Server
Официальный MCP-сервер BrowserStack: реальные устройства, автотесты и тест-кейсы под управлением агента из редактора
Агент получает живую сессию вашего приложения на вебе, iOS или Android, видит экран, пишет тесты и сам проверяет правки.
kogiQA MCP дает агенту браузер, который находит элементы страницы без селекторов, для отладки веб-приложений и e2e-тестов
Фреймворк автоматизации iOS и Android в стиле Playwright: агент ведет телефон по дереву доступности, скилл пишет тесты.
MCP-сервер для сквозных тестов: агент управляет запущенным приложением на Flutter, React Native, Electron или сайтом
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| tapflow MCP Server (эта карточка) | да | ключ необязателен | 1 975 | |
| iOS Simulator MCP Server | нет | не нужна | 2 217 | управляет симулятором iOS на одной машине, без ретранслятора для команды и Android |
| Mobile MCP | нет | не нужна | 10 529 | универсальная автоматизация мобильных устройств, без браузерной панели для команды и воспроизведения YAML-сценариев |
Коротко о README
README проекта объясняет, зачем нужен tapflow командам мобильного QA, и сравнивает его с Appetize, BrowserStack и физическими устройствами. Дальше идут схема из ретранслятора, агента и панели в браузере, быстрый старт и требования. У пакета `@tapflowio/mcp-server` отдельный README.