iPhone

Дайте AI-агентам возможность управлять реальными iPhone и macOS-симуляторами. Автоматизируйте тестирование, сканируйте UI, управляйте приложениями и получайте просмотр экрана в реальном времени. Идеально для AI-ориентированной мобильной разработки и QA.

Инструменты разработчика Мобильная разработка Безопасность и тестирование ★ 48 GitHub (48 ★)

The iPhone tool provides an MCP server that bridges AI agents with iOS devices, enabling seamless control over both physical iPhones and macOS-based simulators. It allows AI agents, such as Claude Code, Cursor, Codex, and OpenCode, to perform a wide range of actions, from tapping and swiping to launching apps, scanning UI elements, and even building and installing WebDriverAgent on physical devices. This facilitates advanced automation, testing, and interaction with iOS applications, bringing AI capabilities directly to the mobile development workflow.

Key Features

0148 GitHub stars

02Automate app launching and device detection

03Scan UI elements with coordinates and retrieve full UI hierarchy

04Control physical iPhones and macOS simulators (tap, swipe, type text, press buttons)

05Take screenshots and list installed applications

06Provide a live screen viewer for connected physical iPhones

Use Cases

01Automated UI testing and bug finding for iOS applications

02AI-driven exploration and interaction with iPhone apps and system features

03Streamlining mobile development workflows by enabling AI to manage devices and apps

iPhone MCP server that lets AI use iPhones

iPhone-mcp

MCP server that lets AI agents control real iPhones and iPhone simulators on MacOS. Works with Claude Code, Cursor, Codex, OpenCode, and any MCP-compatible AI agent.

demo.mp4

Requirements

macOS
Xcode (install from App Store or xcode-select --install)
Node.js 18+
Homebrew

Installation

npm install @blitzdev/iphone-mcp

Quick Start

Global (use in any project)

npx @blitzdev/iphone-mcp --setup-all

This installs dependencies and configures @blitzdev/iphone-mcp for all your AI agents. It automatically sets up Claude Code, Cursor, Codex, OpenCode.

NOTE: For Cursor, you need to enable the blitz-iphone MCP server in Cursor Settings

Project-scoped (one project only)

cd <your project>
npx @blitzdev/iphone-mcp --setup-here

This prompts you to choose which AI agents to configure (Claude Code, Cursor, Codex, OpenCode) and writes the config files into your project directory. @blitzdev/iphone-mcp will only be available when you open an agent inside that directory.

Then just ask

Open a new AI agent session and ask:

> scan the simulator screen and tell me what you see

> connect to my iPhone and test the login flow

> find bugs in my app — tap around, try edge cases, report anything weird

What can it do?

Capability	Simulator	Physical iPhone
Tap, swipe, type text	Yes	Yes
Press buttons (Home, Lock, Siri)	Yes	Yes
Scan UI elements with coordinates	Yes	Yes
Take screenshots	Yes	Yes
List & launch installed apps	Yes	Yes
Auto-detect devices	Yes	Yes
Live screen viewer in browser	--	Yes

iPhones

Connect your iPhone via USB or make sure it's on the same Wi-Fi network (home/office networks work, public cafe Wi-Fi won't).

First-time setup — your iPhone needs:

Developer Mode enabled (Settings > Privacy & Security > Developer Mode)
Trust this computer when prompted on the phone

Then ask your agent:

> connect to my iPhone

The agent will build and install WebDriverAgent on your phone (takes 1-3 minutes the first time), then give you a URL like http://localhost:5152?udid=... — open it in your browser to see a live view of your phone screen.

Simulators

Boot any iPhone simulator, then ask your AI agent to interact with it. No extra setup needed beyond --setup-all or --setup-here.

> what apps are installed on the simulator?
> launch Safari and go to example.com
> take a screenshot

Example session

You:    test the checkout flow in my app
Agent:  Let me scan the simulator to see what's on screen.

        [calls scan_ui]

        I can see the home screen. Let me launch your app first.

        [calls launch_app with bundleId "com.myapp"]
        [calls get_screenshot]

        The app is open on the main screen. I see a "Shop" tab at the bottom.
        Let me tap it and walk through the checkout flow.

        [calls device_action: tap on "Shop" tab]
        [calls scan_ui]

        I see a list of products. Let me add one to cart...

MCP Tools reference

These are the tools your AI agent can call:

Tool	What it does
`get_execution_context`	Find available simulators and iPhones
`scan_ui`	Find tappable elements — buttons, links, text fields — with their coordinates
`describe_screen`	Full UI element hierarchy (more detail than scan_ui)
`device_action`	Tap, swipe, press buttons, type text, press keys
`device_actions`	Run multiple actions in sequence
`get_screenshot`	Save a screenshot and return the file path
`list_devices`	List all simulators and physical devices
`launch_app`	Launch an app by bundle ID
`list_apps`	List installed apps
`setup_device`	Build & install WebDriverAgent on a physical iPhone

Manual MCP configuration

If you'd rather configure things yourself:

Claude Code — add to ~/.claude.json (global) or .mcp.json (project):

{
  "mcpServers": {
    "blitz-iphone": {
      "command": "npx",
      "args": ["@blitzdev/iphone-mcp"]
    }
  }
}

Cursor — add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "blitz-iphone": {
      "command": "npx",
      "args": ["@blitzdev/iphone-mcp"]
    }
  }
}

Codex — add to ~/.codex/config.toml (global) or .codex/config.toml (project):

[mcp_servers.blitz-iphone]
command = "npx"
args = ["@blitzdev/iphone-mcp"]

OpenCode — add to opencode.json in your project root:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "blitz-iphone": {
      "type": "local",
      "command": ["npx", "-y", "@blitzdev/iphone-mcp"],
      "enabled": true
    }
  }
}

Troubleshooting

"No booted simulator found" — Open Simulator.app or run xcrun simctl boot "iPhone 16" first.

Physical device not detected — Make sure Developer Mode is on, the phone is connected via USB, and you've tapped "Trust" on the phone.

WDA build fails — Open Xcode > Settings > Accounts and make sure an Apple ID is signed in. Xcode needs a signing identity to build WDA.

"Connection refused" errors — The idb companion may have crashed. Run npx @blitzdev/iphone-mcp --setup-all again to re-initialize.

License

MIT

iPhone MCP — управляй реальными iPhone и симуляторами через AI-агентов

iPhone MCP — это MCP-сервер, который позволяет AI-агентам (Claude Code, Cursor, Codex, OpenCode и любым совместимым) напрямую взаимодействовать с физическими iPhone и симуляторами на macOS. Под капотом используется WebDriverAgent, что даёт агенту возможность делать тапы, свайпы, вводить текст, делать скриншоты, запускать приложения и многое другое.

Требования

macOS
Xcode (установи из App Store или через xcode-select --install)
Node.js 18+
Homebrew

Установка

npm install @blitzdev/iphone-mcp

Быстрый старт

Глобальная настройка (для всех проектов)

npx @blitzdev/iphone-mcp --setup-all

Эта команда установит зависимости и сконфигурирует сервер для Claude Code, Cursor, Codex и OpenCode. Для Cursor не забудь включить blitz-iphone MCP сервер в настройках (Cursor Settings > MCP).

Настройка для одного проекта

cd <твой_проект>
npx @blitzdev/iphone-mcp --setup-here

Выбери, для каких AI-агентов нужна конфигурация. Сервер будет доступен только когда ты откроешь агента внутри этой директории.

Использование

Просто открой новый сеанс с AI-агентом и попроси что-то вроде:

Отсканируй экран симулятора и расскажи, что видишь

Подключись к моему iPhone и протестируй процесс логина

Найди баги в моём приложении: потапай, попробуй граничные случаи, сообщи о странностях

Возможности

Действие	Симулятор	Физический iPhone
Тап, свайп, ввод текста	✅	✅
Нажатие кнопок (Home, Lock, Siri)	✅	✅
Сканирование UI-элементов с координатами	✅	✅
Скриншоты	✅	✅
Список и запуск установленных приложений	✅	✅
Автоопределение устройств	✅	✅
Просмотр экрана в браузере в реальном времени	—	✅

Работа с физическим iPhone

Подключи iPhone через USB или убедись, что он в той же Wi-Fi-сети (домашняя или рабочая сеть подойдёт, публичный Wi-Fi в кафе — нет).

Первоначальная настройка iPhone

Включи Developer Mode: Настройки > Конфиденциальность и безопасность > Режим разработчика.
При подключении к компьютеру нажми Trust («Доверять») на iPhone.

После этого скажи агенту:

Подключись к моему iPhone

Агент соберёт и установит WebDriverAgent на телефон (первый раз занимает 1-3 минуты), после чего выдаст URL вида http://localhost:5152?udid=.... Открой его в браузере — увидишь экран телефона в реальном времени.

Работа с симуляторами

Запусти любой симулятор iPhone из Xcode, затем попроси AI-агента:

Какие приложения установлены на симуляторе?

Запусти Safari и открой example.com

Сделай скриншот

Никакой дополнительной настройки не требуется, если ты уже выполнил --setup-all или --setup-here.

Пример сессии

Ты: Протестируй процесс оформления заказа в моём приложении

Агент: Дай-ка я посмотрю, что на экране симулятора.

(вызов scan_ui)

Вижу домашний экран. Сначала запущу твоё приложение.

(вызов launch_app с bundleId "com.myapp") (вызов get_screenshot)

Приложение открыто на главном экране. Внизу вижу вкладку «Shop». Тапну по ней и пройду весь флоу оформления.

(вызов device_action: tap на вкладке Shop) (вызов scan_ui)

Вижу список товаров. Добавлю один в корзину...

Справочник MCP-инструментов

Это инструменты, которые AI-агент может вызывать:

get_execution_context — найти доступные симуляторы и iPhone
scan_ui — найти кликабельные элементы (кнопки, ссылки, поля ввода) с координатами
describe_screen — полная иерархия UI (детальнее, чем scan_ui)
device_action — тап, свайп, нажатие кнопок, ввод текста
device_actions — выполнить несколько действий последовательно
get_screenshot — сделать скриншот и вернуть путь к файлу
list_devices — список всех симуляторов и физических устройств
launch_app — запустить приложение по bundle ID
list_apps — список установленных приложений
setup_device — собрать и установить WebDriverAgent на физический iPhone

Ручная конфигурация MCP

Если ты предпочитаешь настраивать всё вручную, добавь соответствующий блок в конфигурационный файл твоего AI-агента.

Claude Code

Добавь в ~/.claude.json (глобально) или .mcp.json (в проекте):

{
  "mcpServers": {
    "blitz-iphone": {
      "command": "npx",
      "args": ["@blitzdev/iphone-mcp"]
    }
  }
}

Cursor

Добавь в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (в проекте):

{
  "mcpServers": {
    "blitz-iphone": {
      "command": "npx",
      "args": ["@blitzdev/iphone-mcp"]
    }
  }
}

Codex

Добавь в ~/.codex/config.toml (глобально) или .codex/config.toml (в проекте):

[mcp_servers.blitz-iphone]
command = "npx"
args = ["@blitzdev/iphone-mcp"]

OpenCode

Добавь в opencode.json в корне проекта:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "blitz-iphone": {
      "type": "local",
      "command": ["npx", "-y", "@blitzdev/iphone-mcp"],
      "enabled": true
    }
  }
}

Устранение неполадок

«No booted simulator found» — сначала запусти Simulator.app или выполни xcrun simctl boot "iPhone 16".
Физическое устройство не обнаружено — проверь, что включён Developer Mode, телефон подключён по USB и ты нажал «Trust».
Ошибка сборки WDA — открой Xcode > Settings > Accounts и убедись, что выполнен вход с Apple ID. Xcode требуется signing identity для сборки WDA.
Ошибки «Connection refused» — возможно, упал idb companion. Запусти npx @blitzdev/iphone-mcp --setup-all заново для переинициализации.

Лицензия

MIT

Источник: https://mcpmarket.com/server/iphone-1