Poki MCP
Poki, локальный MCP-сервер для macOS, отдает агенту iPhone или симулятор iOS: экран, касания, ввод текста и приложения.
- 402 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент управляет настоящим iPhone: по просьбе он отправит сообщения и проведет платеж.
- Содержимое экрана, включая личную переписку, уходит настроенной модели.
Установка
- Работает в
Ручная установка
git clone https://github.com/JosssphZhou/poki.gitДальше `cd poki`, `./bin/setup`, `npm start` и регистрация `node src/stdio.mjs` в клиенте.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент управляет настоящим iPhone: по просьбе он отправит сообщения и проведет платеж.
- Содержимое экрана, включая личную переписку, уходит настроенной модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Poki запускает на Mac локальную службу и открывает агенту инструменты управления настоящим iPhone или симулятором iOS. Агент делает снимок экрана, читает дерево элементов через Accessibility или Vision OCR, нажимает, листает, вводит текст, открывает ссылки и запускает приложения. По умолчанию в списке инструментов лежат только команды для задач на телефоне, полный каталог включает `POKI_MCP_TOOLS=all`. Рядом в репозитории есть отдельный терминальный агент Poki Agent с каналами iMessage и Telegram и запоминанием повторяющихся задач.
Для кого. Разработчикам и тестировщикам мобильных приложений, которые проверяют сценарии на живом iPhone через Claude Code или Codex.
Подходит, если
- Агент проходит сценарий в приложении на симуляторе и сверяет экраны.
- Нужно воспроизвести ошибку на физическом iPhone без ручных нажатий.
- Скриншоты и дерево элементов собирают для отчета о баге.
- Повторяющуюся задачу на телефоне поручают агенту с памятью маршрутов.
Не подходит, если
- Mac нет: сервер работает только на macOS 15 и новее с полным Xcode.
- Содержимое экрана нельзя отправлять модели.
- Телефон с личной перепиской и платежными приложениями подключают без ограничений.
Пример запроса к агенту
Открой Chrome на подключенном iPhone, найди esp32 и перескажи первый результат, прикладывая скриншот каждого шага.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
POKI_MCP_TOOLS- Значение `all` открывает полный каталог инструментов.
POKI_NO_UPDATE_CHECK- Значение `1` отключает ежедневную проверку релизов.
Ограничения
Сборка требует Xcode, Rust, Node.js версии 24 и новее и ffmpeg, первая сборка занимает несколько минут. Работу на физическом iPhone проверяли только с китайским интерфейсом, поддерживается портретная ориентация. Экспорт контейнеров приложений и прямые ссылки на подразделы настроек недоступны. Лицензия AGPL-3.0. Для чувствительных действий предусмотрены локальные подтверждения, а режим подтверждений показывает `poki_mcp_status`. Ошибки в настройке подключения проще найти через `poki_mcp_status`.
Как отключить. Удалите запись `poki-mcp` из настроек клиента и остановите `npm start`. Отключите iPhone от Mac и снимите пары в Xcode, если больше не работаете с ним.
Частые вопросы
Какие инструменты видит агент по умолчанию?
Команды для задач на телефоне: `list_elements`, `take_screenshot`, `tap`, `type_text`, `scroll`, `launch_app`, `open_url`, `wait_for` и `batch_commands`. Полный каталог включает `POKI_MCP_TOOLS=all`.
Нужна ли отдельная подписка на модель?
Нет, если подключить Poki MCP к Claude Code или Codex: работает ваша подписка. Отдельный Poki Agent использует собственную настройку модели.
Что уходит наружу?
Содержимое экрана отправляется настроенной модели. Служба по умолчанию слушает только `127.0.0.1`, а проверка новых релизов отключается через `POKI_NO_UPDATE_CHECK=1`.
Есть ли Linux?
Репозиторий нацелен на macOS. Для Linux есть сторонний порт `poki-for-linux`, его поддерживают вне проекта.
Как подключить Poki к Claude Code или Codex?
Из каталога проекта выполните `claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"` для Claude Code или `codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"` для Codex.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОткрытая модель и фреймворк агента для смартфона: видит экран и сам нажимает в приложениях Android, HarmonyOS и iOS по текстовой команде
Artemis
artemis
Каркас Google для управления реальным устройством Android или эмулятором по инструкциям на естественном языке: UI-тесты и повседневные задачи
Android-эмулятор в Docker с MCP-сервером: агент управляет устройством по adb, открывает приложения и страницы, нажимает кнопки
Официальные 30 скиллов команды Android: Jetpack Compose, обновление AGP 9, R8, профилирование Perfetto, Navigation 3, CameraX и политики Google Play
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
XcodeGen, генератор проектов Xcode, разделяет общие настройки между целями: команда поддерживает одну текстовую спецификацию.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Poki (эта карточка) | нет | не нужна | 402 | |
| Mobile MCP | нет | не нужна | 10 325 | mobile-mcp работает с устройствами через общий слой автоматизации; Poki добавляет терминальный агент и маршруты, которые запоминаются |
| Appium MCP | да | не нужна | 518 | appium-mcp опирается на Appium; Poki ставит собственный мост для iPhone и симулятора |
Коротко о README
Корневой `AGENTS.md` описывает установку, которую агент выполняет сам и останавливается, когда нужны действия владельца. Для физического iPhone сначала нужна пара с Mac по USB.