simulator-use — MCP-сервер для Claude Code
MCP-сервер simulator-use, который даёт агенту доступ к iOS Simulator: собирает проект Xcode, читает экран как текст и тапает по лейблам элементов.
MIT ★ 6 обновлён 2026-10-26
claude mcp add simulator-use -- npx -y simulator-useЧто делает simulator-use
simulator-use собирает и запускает проект Xcode, превращает экран в несколько строк текста вместо полного дерева accessibility, и позволяет агенту тапать и вводить текст по #id или подписи элемента. Отдельный инструмент tests_run прогоняет unit- и UI-тесты по каждому кейсу с номером строки для упавших. Свой движок обращается к Simulator напрямую, минуя запуск вспомогательного процесса на каждый вызов.
Шаги для ui_act — tap, fill, scroll, swipe, wait — выполняются по очереди, и каждый из них проверяется: введённый текст считывается обратно из поля, а тап без видимых изменений экрана помечается отдельно. Веб-вью внутри UIKit-приложений (Capacitor, React Native WebView) читаются построчно, а вот страницы в SwiftUI WebView, Safari и внутренние браузеры accessibility не видит — в этих местах придётся работать по скриншоту и координатам.
Работает на Mac с установленным Xcode; с Linux, Windows или Mac без Xcode доступ к Simulator идёт через облачный iPhone по команде npx simulator-use cloud start.
Какие задачи решает
- собрать и запустить проект Xcode из агента
- прочитать экран приложения как текст вместо скриншота
- тапать и вводить текст по accessibility id без координат
- прогнать XCTest и XCUITest по каждому кейсу с логами ошибок
- получить доступ к Simulator с Linux или Windows через облачный iPhone
Примеры запросов агенту
- Собери проект Xcode и покажи первый экран
- Заполни поле #email значением [email protected] и нажми #signIn
- Запусти тесты и покажи, какие упали
Как установить simulator-use
Командой платформы
claude mcp add simulator-use -- npx -y simulator-useКомандой платформы
codex mcp add simulator-use -- npx -y simulator-useФайл настроек
{
"mcpServers": {
"simulator-use": {
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Файл настроек
{
"servers": {
"simulator-use": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Командой платформы
gemini mcp add simulator-use npx -y simulator-useПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о simulator-use
Как установить simulator-use в Claude Code?
Выполните claude mcp add simulator-use -- npx -y simulator-use.
Что делает simulator-use?
Он собирает и запускает iOS-проект через Xcode, показывает содержимое экрана Simulator как текст и позволяет агенту тапать, вводить текст и запускать тесты по названию элемента, а не по координатам.
Можно ли использовать simulator-use без Xcode на Mac?
Да, через npx simulator-use cloud start доступен облачный iPhone с Xcode — это работает и с Linux, и с Windows, и с Mac без Xcode.