Peekaboo MCP

CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу

  • 5 405 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Видит весь экран и управляет вводом в любых приложениях
  • Требует системных разрешений на запись экрана и универсальный доступ
Все причины и проверки

openclaw/peekaboo

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/peekaboo

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Видит весь экран и управляет вводом в любых приложениях
  • Требует системных разрешений на запись экрана и универсальный доступ

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Peekaboo снимает экран, окна и приложения на Mac и строит структурированную карту интерфейса с идентификаторами элементов. По этой карте агент кликает, вводит текст, нажимает клавиши, прокручивает, управляет окнами, меню, Dock и диалогами. Действия можно привязать к конкретному окну, и во многих случаях они доставляются в фоне без переключения приложения. Тот же набор инструментов доступен как MCP-сервер через stdio, а встроенный агент выполняет многошаговые задачи по описанию на естественном языке.

Для кого. Для разработчиков и энтузиастов автоматизации на macOS, которым нужно, чтобы агент видел экран и работал с нативными приложениями.

Подходит, если

  • Нужно, чтобы агент проверил, как выглядит окно вашего приложения
  • Нужно автоматизировать действия в нативном приложении macOS без API
  • Нужно дать Codex или Claude Code скриншоты и управление интерфейсом

Не подходит, если

  • Работаете на Windows или Linux: для них сообщество сделало отдельные версии
  • Нельзя выдавать разрешения на запись экрана и универсальный доступ

Пример запроса к агенту

Сделай скриншот окна моего приложения и проверь, не обрезаны ли подписи кнопок

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

Нужны macOS 15 или новее, для npm-пакета Node 22 или новее. Требуются разрешения на запись экрана и универсальный доступ. HTTP и SSE транспорты пока не реализованы, только stdio. Встроенному агенту и анализу изображений нужен настроенный провайдер моделей.

Как отключить. Удалите блок peekaboo из конфигурации MCP, отзовите разрешения в системных настройках и удалите CLI через brew uninstall.

Частые вопросы

Нужно ли приложению быть на переднем плане?

Часто нет: при указании окна ввод доставляется в фоне, а действия без точной цели требуют явного разрешения на передний план.

Где старый репозиторий steipete/Peekaboo?

Проект переехал в организацию openclaw, npm-пакет по-прежнему называется @steipete/peekaboo.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса

MCP-серверШирокий доступ355Звезды репозитория

MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API

MCP-серверШирокий доступ414Звезды репозитория

MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell

MCP-серверШирокий доступ10,7 тыс.Звезды репозитория

MCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов

MCP-серверШирокий доступ465Звезды репозитория

Open Computer Use

open-computer-use

Открытый MCP-сервер для управления рабочим столом: агент читает состояние приложений и кликает, печатает, скроллит на macOS, Linux и Windows

MCP-серверШирокий доступ2,8 тыс.Звезды репозитория

Коротко о README

README показывает установку CLI через Homebrew, npm-пакет с MCP и приложение для строки меню. Быстрый старт объясняет проверку разрешений, снимок экрана и разбор интерфейса приложения в JSON. Приведены пример автоматизации Safari по идентификатору окна, запуск агента и карта команд по задачам. Настройка MCP-клиентов вынесена в docs/MCP.md. Лицензия MIT.

Бейдж для README

Сообщить о проблеме

Foxx AIPeekaboo
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.