ios-simulator-mcp

ios-simulator-mcp

от joshuayoes
Управляет iOS-симулятором на Mac: тапает по экрану, вводит текст, свайпает, делает скриншоты и видео, устанавливает и запускает приложения.

iOS Simulator MCP Server

Install MCP Server NPM Version

A Model Context Protocol (MCP) server for interacting with iOS simulators. This server allows you to interact with iOS simulators by getting information about them, controlling UI interactions, and inspecting UI elements.

Security Notice: Command injection vulnerabilities present in versions < 1.3.3 have been fixed. Please update to v1.3.3 or later. See SECURITY.md for details.

https://github.com/user-attachments/assets/a88e449c-8f1d-46a5-9816-0f97e071c460

This project has been featured and mentioned in various publications and resources:

Часто задаваемые вопросы

Инструменты были проиндексированы:
get_booted_sim_idтолько чтениевнешний мир

Получить идентификатор текущего запущенного симулятора iOS

Параметры

Без параметров.

install_appвнешний мир

Устанавливает пакет приложения (.app или .ipa) на симулятор iOS.

Параметры
  • app_pathstringобязательный

    Путь к пакету приложения (каталог .app или файл .ipa) для установки

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

launch_appвнешний мир

Запускает приложение на iOS Simulator по bundle identifier.

Параметры
  • bundle_idstringобязательный

    Bundle identifier приложения для запуска (например, com.apple.mobilesafari)

  • envobject

    Переменные окружения для передачи в simctl launch

  • terminate_runningboolean

    Завершите работу приложения, если оно уже запущено, перед его запуском.

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

list_appsтолько чтениевнешний мир

Перечисляет все установленные приложения в iOS Simulator с их bundle identifiers и display names.

Параметры
  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

open_simulatorвнешний мир

Открывает приложение iOS Simulator

Параметры

Без параметров.

open_urlвнешний мир

Открывает URL в iOS Simulator, полезно для тестирования deep links и universal links.

Параметры
  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

  • urlstringобязательный

    URL или глубокая ссылка для открытия (например, https://example.com или myapp://screen/detail)

record_videoвнешний мир

Записывает видео симулятора iOS напрямую с помощью simctl

Параметры
  • codecenum

    Указывает тип кодека: "h264" или "hevc". По умолчанию: "hevc".

  • displayenum

    Какой дисплей захватывать: «внутренний» или «внешний». По умолчанию зависит от типа устройства.

  • forceboolean

    Принудительно записать выходной файл, даже если он уже существует.

  • maskenum

    Для непрямоугольных дисплеев обрабатывайте маску согласно политике: «ignored», «alpha» или «black».

  • output_pathstring

    Необязательный путь вывода. Если он не указан, будет использовано имя по умолчанию. Файл сохранится в каталог, заданный переменной IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR, или в ~/Downloads, если переменная окружения не установлена.

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

screenshotвнешний мир

Делает скриншот iOS Simulator

Параметры
  • displayenum

    Какой дисплей захватывать: «внутренний» или «внешний». По умолчанию зависит от типа устройства.

  • maskenum

    Для непрямоугольных дисплеев обрабатывайте маску согласно политике: «ignored», «alpha» или «black».

  • output_pathstringобязательный

    Путь к файлу, куда будет сохранён скриншот. Если путь относительный, используется каталог, указанный в переменной окружения IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR, или ~/Downloads, если она не задана.

  • typeenum

    Формат изображения (png, tiff, bmp, gif или jpeg). По умолчанию используется png.

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

stop_recordingвнешний мир

Останавливает видеозапись симулятора с помощью killall

Параметры

Без параметров.

terminate_appвнешний мир

Завершает запущенное приложение на iOS Simulator по идентификатору bundle.

Параметры
  • bundle_idstringобязательный

    Идентификатор пакета приложения для завершения (например, com.apple.mobilesafari)

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

ui_describe_allтолько чтениевнешний мир

Описывает информацию о доступности для всего экрана в iOS Simulator

Параметры
  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

ui_describe_pointтолько чтениевнешний мир

Возвращает элемент доступности по заданным координатам на экране iOS Simulator

Параметры
  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

  • xnumberобязательный

    Координата x

  • ynumberобязательный

    y-координата

ui_find_elementтолько чтениевнешний мир

Ищет в дереве доступности и возвращает элементы, соответствующие заданным критериям

Параметры
  • caseSensitiveboolean

    Определяет, учитывает ли поиск регистр символов (по умолчанию: false).

  • matchModeenum

    Режим сопоставления строк поиска: 'подстрока' (по умолчанию) или 'точно'.

  • searchstring[]обязательный

    Массив строк поиска. Элемент совпадает, если ЛЮБАЯ строка совпадает с его AXLabel или AXUniqueId.

  • typestring

    Фильтровать по типу элемента (например, 'Button', 'StaticText', 'Group'). Точное совпадение без учета регистра.

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

ui_swipeвнешний мир

Проводит по экрану в iOS Simulator.

Параметры
  • deltanumber

    Размер каждого шага при свайпе (по умолчанию — 1)

  • durationstring

    Длительность свайпа в секундах (например, 0.1).

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

  • x_endnumberобязательный

    Конечная x-координата

  • x_startnumberобязательный

    Начальная x-координата

  • y_endnumberобязательный

    Конечная y-координата

  • y_startnumberобязательный

    Начальная y-координата

ui_tapвнешний мир

Нажмите на экран в iOS Simulator

Параметры
  • durationstring

    Длительность нажатия

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

  • xnumberобязательный

    Координата x

  • ynumberобязательный

    Координата x

ui_typeвнешний мир

Ввод текста в симулятор iOS

Параметры
  • textstringобязательный

    Текст для ввода

  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

ui_viewтолько чтениевнешний мир

Получить содержимое изображения сжатого скриншота текущего вида симулятора

Параметры
  • udidstring

    UDID цели также можно задать с помощью переменной окружения IDB_UDID.

2.1.0основная
2.0.0
1.6.0
1.5.2
1.5.1
1.5.0
1.4.3
1.4.2
1.4.1
1.4.0
1.3.3
1.3.2
1.3.1
1.3.0
1.2.0
1.1.0
1.0.0

Выберите клиент, чтобы установить ios-simulator-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "type": "stdio",
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ios-simulator-mcp-uv42qbrm0r\",\"type\":\"stdio\",\"args\":[\"-y\",\"ios-simulator-mcp\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add ios-simulator-mcp-uv42qbrm0r -- npx -y ios-simulator-mcp

Либо через JSON-конфиг:

claude mcp add-json ios-simulator-mcp-uv42qbrm0r "{\"args\":[\"-y\",\"ios-simulator-mcp\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add ios-simulator-mcp-uv42qbrm0r -- npx -y ios-simulator-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ios-simulator-mcp-uv42qbrm0r]
command = "npx"
args = ["-y", "ios-simulator-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите ios-simulator-mcp, а в поле команды запуска — строку ниже:
npx -y ios-simulator-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например ios-simulator-mcp-uv42qbrm0r.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ios-simulator-mcp-uv42qbrm0r
    command: npx
    args:
      - "-y"
      - "ios-simulator-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ios-simulator-mcp-uv42qbrm0r": {
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "command": "npx"
    }
  }
}

Похожие MCP-сервера

mobile-next/mobile-mcp

mobile-next/mobile-mcp

от mobile-next

Mobile Next управляет iOS и Android: запускает приложения, кликает по экрану и выгружает данные с него на эмуляторах, симуляторах и реальных устройствах.

TypeScript⭐ 9785
martingeidobler/android-mcp-server

martingeidobler/android-mcp-server

от martingeidobler

MCP сервер для управления Android через ADB: AI ассистент видит экран, тапает элементы, читает логи и устанавливает приложения. Включает 25 инструментов для отладки и тестирования без модификации кода. Полезен Android-разработчикам и тестировщикам.

TypeScript⭐ 68
ambar/simctl-mcp

ambar/simctl-mcp

от ambar

MCP сервер для iOS Simulator автоматизирует: управление устройствами и приложениями, отправку push-уведомлений, работу с буфером обмена. Полезен iOS-разработчикам и QA-инженерам для тестирования.

TypeScript⭐ 20
joshuarileydev/simulator-mcp-server

joshuarileydev/simulator-mcp-server

от joshuarileydev

MCP-сервер для управления iOS симуляторами: запуск, остановка, установка .app и запуск приложений по bundle ID. Полезен iOS-разработчикам для автоматизации тестирования и CI/CD.

JavaScript⭐ 53
Neverlow512/agent-droid-bridge

Neverlow512/agent-droid-bridge

от neverlow512

MCP-сервер для подключения AI-агентов к Android-устройствам через ADB. Используется в мобильной автоматизации, тестировании и реверс-инжиниринге: скриншоты, касания, ввод текста, управление приложе...

Python⭐ 22
callstackincubator/agent-device

callstackincubator/agent-device

от callstackincubator

agent-device — CLI для автоматизации устройств, позволяющий AI-агентам открывать приложения на iOS, Android и десктопе, инспектировать UI, взаимодействовать с элементами и собирать отладочную инфор...

TypeScript⭐ 5078
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин