iphone-mirroir-mcp

iphone-mirroir-mcp

jfarcandApache-2.0
108 звёзд14 форков
Mirroir MCP — это сервер, который подключает AI-ассистента к реальному iPhone через macOS iPhone Mirroring. Вам не нужен эмулятор или симулятор. Сервер работает с настоящим физическим устройством. AI-агент получает скриншоты экрана и может нажимать на кнопки, свайпать и вводить текст — всё как человек. Сервер ориентирован на разработчиков iOS, QA-инженеров и всех, кто автоматизирует тестирование на реальных устройствах. 33 встроенных инструмента покрывают большинство сценариев взаимодействия с iPhone. Поддерживаются macOS 15+.
Открыть на GitHub

Установка

npx -y iphone-mirroir-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикjfarcand
  • ЛицензияApache-2.0

Технологии

  • Языки
    Swift
  • Транспорт
    stdio

Описание

Возможности

  • Захватывать скриншот экрана iPhone и передавать его AI-ассистенту для анализа
  • Нажимать на указанные координаты или элементы интерфейса
  • Выполнять свайпы вверх, вниз, влево и вправо
  • Вводить текст в активные поля ввода
  • Запускать и завершать приложения на устройстве
  • Имитировать системные жесты: возврат на главный экран, переключение между приложениями
  • Получать список установленных приложений
  • Получать информацию об устройстве: заряд батареи, версия iOS
  • Открывать Пункт управления и Центр уведомлений
  • Работать с окнами macOS в качестве дополнительной цели (экспериментальная функция)

Как подключить

Установите сервер. Выполните команду в терминале:

npx -y iphone-mirroir-mcp

Можно использовать установочный скрипт. Он проверит зависимости и настроит всё автоматически:

/bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"

Добавьте сервер в MCP-клиент. Пример для Claude Desktop (файл конфигурации):

{ "mcpServers": { "mirroir": { "command": "npx", "args": ["-y", "iphone-mirroir-mcp"] } } }

Перезапустите клиент. При первом запуске macOS запросит разрешения на запись экрана и управление компьютером — предоставьте их.

Примеры запросов

  • «Сделай скриншот экрана iPhone и опиши, что на нём открыто»
  • «Открой приложение "Новости" и покажи сегодняшнюю подборку»
  • «Проведи вверх, чтобы открыть список приложений, и найди приложение "Календарь"»
  • «Нажми на кнопку "Записать" в приложении "Диктофон"»

Технические детали

  • Язык разработки: Swift
  • Транспорт: stdio
  • Лицензия: Apache 2.0
  • Версия macOS: 15+
  • Совместимость с клиентами: любые MCP-клиенты (Claude Desktop, Claude Code, Cursor, GitHub Copilot, OpenAI Codex)

Поделиться