Об этом проекте

Mobile MCP — это сервер Model Context Protocol (MCP) для мобильной разработки и автоматизации. Он предоставляет платформенно-независимый интерфейс, чтобы агенты и LLM могли взаимодействовать с нативными приложениями iOS и Android без необходимости отдельных знаний iOS или Android. Он работает с MCP-совместимыми клиентами, такими как Claude Code, Codex, Gemini, GitHub Copilot и Antigravity, и может нацеливаться на устройства на локальной машине или удалённые устройства через облачный сервис. Поддерживаемые цели включают симуляторы iOS (через Xcode и xcrun simctl), реальные устройства iOS, подключённые по USB, эмуляторы Android (через adb) и реальные устройства Android с включённой отладкой по USB. Сервер распространяется как npm-пакет и обычно запускается через npx — либо по stdio, либо как Streamable HTTP-сервер с флагом --listen. Для режима HTTP можно потребовать опциональный Bearer-токен через переменную окружения. Набор инструментов охватывает управление устройствами (список устройств, размер экрана, получение/установка ориентации, переопределение GPS-локации, чтение/замена буфера обмена), управление приложениями (список, приложение на переднем плане, запуск, завершение, установка, удаление), взаимодействие с экраном (скриншоты, сохранение скриншотов, список элементов UI с координатами, нажатия, двойные нажатия, длительное нажатие, свайпы, запись экрана), ввод и навигацию (ввод текста, аппаратные кнопки, открытие URL) и логи и отчёты о сбоях (логи устройства, список и получение сбоев). Инструмент пакетных команд выполняет несколько инструментов последовательно за один вызов. Инструменты удалённых устройств позволяют войти в облачного провайдера, перечислять, выделять и освобождать облачные устройства. Проект делает акцент на подходе «сначала доступность»: он управляет приложениями из нативного дерева доступности, а не с помощью модели зрения, при необходимости переключаясь на скриншоты и координаты, что, как указано в README, быстрее и дешевле, чем подходы только со скриншотами. Вывод описывается как структурированный и детерминированный. Предварительные требования включают инструменты командной строки Xcode, инструменты платформы Android, Node.js v20 или новее и агент или модель с поддержкой MCP. Примеры конфигурации приведены для многих клиентов, включая Amp, Antigravity, Cline, Claude Code, Claude Desktop, Codex, Copilot, Cursor, Gemini CLI, Goose, Kiro, opencode и Windsurf. Переменные окружения управляют аутентификацией, отказом от телеметрии, небезопасными схемами URL и устаревшим режимом робота. Анонимная телеметрия собирается по умолчанию и может быть отключена. Репозиторий также указывает на связанные проекты: mobilewright для повторяемых детерминированных мобильных тестов, mobilecli как базовый CLI для устройств и облачное предложение для реальных устройств по требованию. Ссылки ведут на документацию, дорожную карту, руководство по участию и кодекс поведения. В README указано, что сервер работает локально и взаимодействует только с подключёнными устройствами, а отдельная политика конфиденциальности описывает детали сбора данных.