MCP Server for iOS Simulator
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
- 342 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент ставит и удаляет приложения, очищает связку ключей и меняет данные симулятора
- Установка меняет систему: через Homebrew добавляется idb-companion, а в окружение Python ставится fb-idb
Установка
- Работает в
Ручная установка
git clone https://github.com/InditexTech/mcp-server-simulator-ios-idb.git && cd mcp-server-simulator-ios-idb && python3 -m venv venv && source venv/bin/activate && npm install && npm run buildУстановка ставит idb-companion через Homebrew и fb-idb через pip.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент ставит и удаляет приложения, очищает связку ключей и меняет данные симулятора
- Установка меняет систему: через Homebrew добавляется idb-companion, а в окружение Python ставится fb-idb
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает языковую модель с iOS-симулятором на Mac. Клиент MCP отправляет в единственный инструмент process-instruction фразу вроде «create simulator iPhone 14» или «tap at 100, 200». Встроенный разборщик превращает фразу в команду, а команды выполняются через idb и через `xcrun simctl`. Сервер создает и завершает сессии симулятора, запускает и останавливает устройства, ставит сборки .ipa. Приложения он запускает, закрывает и удаляет. Для интерфейса есть нажатия, свайпы, кнопки и ввод текста. Дерево доступности возвращает элементы экрана или описывает элемент в заданной точке. Для отладки сервер делает скриншоты, записывает видео и достает системные логи и логи приложения. Отчеты о сбоях он показывает и удаляет. Дополнительные команды подменяют геопозицию, добавляют фото в галерею, выдают разрешения приложению и очищают связку ключей.
Для кого. Для iOS-разработчиков и тестировщиков, которые хотят командовать симулятором из Claude Desktop, Cline или другого клиента MCP простыми фразами.
Подходит, если
- Нужно поднять симулятор iPhone, поставить сборку и запустить приложение одной серией фраз
- Нужно прогнать нажатия по экрану и свайпы по описанию без Xcode UI и скриптов XCTest
- Нужно вытащить логи приложения или свежий отчет о сбое после падения
- Нужно подменить геопозицию, добавить фото в галерею и выдать разрешения перед проверкой сценария
- Нужно записать видео прохода по приложению для описания бага
Не подходит, если
- Нужен настоящий iPhone: сервер работает только с симуляторами
- Нет Mac с Xcode: macOS и установленный Xcode обязательны
- Нужны Android-эмуляторы: проект покрывает только iOS
- Нужен проверенный тестовый набор для CI: разборщик понимает фиксированный набор фраз, и нестандартная формулировка может не сработать
Пример запроса к агенту
Создай сессию симулятора iPhone 14, поставь /path/to/my-app.ipa, запусти com.example.myapp и сделай скриншот.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны macOS, Node.js 20 или новее, Homebrew и Xcode с установленными симуляторами. Установщик ставит fb-idb в виртуальное окружение Python, и перед каждым запуском окружение надо активировать командой `source venv/bin/activate`.
В настройках MCP указывают путь к собранному файлу dist/index.js, поэтому сначала проект клонируют и собирают командами npm. Пакета для запуска через npx нет.
При импорте корневой точки пакета сразу стартует сервер MCP на stdio, и отключить это нельзя.
Как отключить. Уберите блок ios-simulator из настроек клиента MCP и остановите процесс командой `Ctrl+C`. Папку проекта вместе с виртуальным окружением можно удалить, а idb-companion убирается командой `brew uninstall idb-companion`.
Частые вопросы
Как подключить MCP Server for iOS Simulator к Claude Desktop?
Склонируйте репозиторий, выполните `npm install` и `npm run build`, затем добавьте в настройки сервер ios-simulator с командой node и аргументом /path/to/mcp-server-simulator-ios-idb/dist/index.js. После перезапуска клиента можно писать фразы про симулятор. Самый короткий путь в Cline: попросить добавить этот MCP по ссылке на репозиторий.
Какие фразы понимает сервер?
Разборщик знает фиксированный набор: «create session», «list simulators», «boot simulator» с UDID, «install app», «launch app», «tap at 100, 200», «take screenshot», «get logs», «set location» и другие.
Работает ли сервер с настоящим iPhone?
Нет. Все примеры и команды относятся к симуляторам, в том числе выбор устройства по UDID. Для настоящего телефона нужен другой инструмент.
Что ставится при установке на компьютер?
Установщик проверяет, что это macOS, ставит idb-companion через Homebrew и пакет fb-idb командой pip в виртуальное окружение. Поэтому установка меняет систему и выходит за папку проекта.
Можно ли использовать код как библиотеку?
Да, но с оговоркой: импорт корня пакета запускает сервер MCP. Чтобы брать только разборщик, оркестратор и менеджер idb, импортируйте их из dist/parser, dist/orchestrator и dist/idb по глубоким путям.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
Десктопное приложение и CLI для Android-эмуляторов, iOS-симуляторов и телефонов с MCP-сервером для агента
MCP-сервер управляет реальным iPhone через macOS iPhone Mirroring: агент видит экран, нажимает, листает и вводит текст
Команда npx serve-sim выводит симулятор iOS в браузер и позволяет агенту нажимать, свайпать, вводить текст и подменять камеру
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP Server for iOS Simulator (эта запись) | нет | не нужна | 342 | |
| Mobile MCP | нет | не нужна | 10 095 | управляет iOS и Android, симуляторами и реальными устройствами, а этот сервер ограничен симуляторами iOS |
| iOS Simulator Skill | нет | 1 302 | скилл со скриптами сборки и управления симулятором, а этот сервер принимает команды на обычном языке через MCP | |
| mirroir-mcp | нет | не нужна | 269 | MCP-сервер управляет реальным iPhone через macOS iPhone Mirroring |
Коротко о README
Проект состоит из трех компонентов: разборщика фраз, оркестратора и менеджера idb, которые связаны адаптерами. Поток выполнения и модель сессий подробно разобраны в файле ARCHITECTURE.md.