Peekaboo
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
Установка
{
"mcpServers": {
"peekaboo": {
"command": "npx",
"args": ["-y", "@steipete/peekaboo", "mcp"]
}
}
}Из docs/MCP.md, подходит для Codex, Claude Code и Cursor.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Peekaboo снимает экран, окна и приложения на Mac и строит структурированную карту интерфейса с идентификаторами элементов. По этой карте агент кликает, вводит текст, нажимает клавиши, прокручивает, управляет окнами, меню, Dock и диалогами. Действия можно привязать к конкретному окну, и во многих случаях они доставляются в фоне без переключения приложения. Тот же набор инструментов доступен как MCP-сервер через stdio, а встроенный агент выполняет многошаговые задачи по описанию на естественном языке.
Для кого. Для разработчиков и энтузиастов автоматизации на macOS, которым нужно, чтобы агент видел экран и работал с нативными приложениями.
Подходит, если
- Нужно, чтобы агент проверил, как выглядит окно вашего приложения
- Нужно автоматизировать действия в нативном приложении macOS без API
- Нужно дать Codex или Claude Code скриншоты и управление интерфейсом
Не подходит, если
- Работаете на Windows или Linux: для них сообщество сделало отдельные версии
- Нельзя выдавать разрешения на запись экрана и универсальный доступ
Пример запроса к агенту
Сделай скриншот окна моего приложения и проверь, не обрезаны ли подписи кнопокОграничения
Нужны macOS 15 или новее, для npm-пакета Node 22 или новее. Требуются разрешения на запись экрана и универсальный доступ. HTTP и SSE транспорты пока не реализованы, только stdio. Встроенному агенту и анализу изображений нужен настроенный провайдер моделей.
Как отключить. Удалите блок peekaboo из конфигурации MCP, отзовите разрешения в системных настройках и удалите CLI через brew uninstall.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Видит весь экран и управляет вводом в любых приложениях
- Требует системных разрешений на запись экрана и универсальный доступ
Коротко о README
README показывает установку CLI через Homebrew, npm-пакет с MCP и приложение для строки меню. Быстрый старт объясняет проверку разрешений, снимок экрана и разбор интерфейса приложения в JSON. Приведены пример автоматизации Safari по идентификатору окна, запуск агента и карта команд по задачам. Настройка MCP-клиентов вынесена в docs/MCP.md. Лицензия MIT.
Частые вопросы
Нужно ли приложению быть на переднем плане?
Часто нет: при указании окна ввод доставляется в фоне, а действия без точной цели требуют явного разрешения на передний план.
Где старый репозиторий steipete/Peekaboo?
Проект переехал в организацию openclaw, npm-пакет по-прежнему называется @steipete/peekaboo.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub