Ghost OS MCP
MCP-сервер на Swift для macOS: агент видит любое приложение через дерево доступности, кликает, печатает и сохраняет сценарии как рецепты в JSON
- 1 681 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Управляет любыми приложениями Mac от вашего имени: нажимает кнопки, печатает текст, отправляет письма и сообщения
- Режим обучения читает клавиатуру и мышь через системный перехват событий и сохраняет ваши действия вместе с содержимым элементов
- Мастер записывает в настройки Claude Code разрешение на все свои инструменты и тем самым отключает подтверждения
Установка
- Работает в
Ручная установка
brew install ghostwright/ghost-os/ghost-osСтавит команду `ghost`. Нужен Homebrew и macOS 14 или новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет любыми приложениями Mac от вашего имени: нажимает кнопки, печатает текст, отправляет письма и сообщения
- Режим обучения читает клавиатуру и мышь через системный перехват событий и сохраняет ваши действия вместе с содержимым элементов
- Мастер записывает в настройки Claude Code разрешение на все свои инструменты и тем самым отключает подтверждения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ghost OS — MCP-сервер на Swift, который дает агенту управление приложениями на Mac. Установка идет через Homebrew, а команда `ghost setup` выдает права, прописывает сервер в Claude Code, копирует рецепты и готовит модель зрения. По описанию автора, сервер отдает агенту 29 инструментов: просмотр, нажатия, ввод, прокрутка, перетаскивание, управление окнами и ожидание условий. Интерфейс агент читает через дерево доступности macOS, то есть получает названия, роли и положение элементов. Если дерева не хватает, например в веб-приложениях вроде Gmail или Slack, инструменты `ghost_ground` и `ghost_parse_screen` обращаются к локальной модели ShowUI-2B. Она работает в Python-помощнике на `localhost:9876`, который запускается по необходимости. Скриншоты для основной работы не нужны, они остаются отдельным инструментом для отладки. Знакомый сценарий можно записать рецептом. Рецепт — JSON-файл с шагами, параметрами и условиями ожидания в `~/.ghost-os/recipes`. Инструмент `ghost_run` выполняет его с подстановкой параметров, а в репозитории лежат четыре готовых: отправка письма в Gmail, сообщение в Slack, папка в Finder и загрузка статьи с arXiv. Режим обучения `ghost_learn_start` наблюдает за вашими действиями вручную, после `ghost_learn_stop` агент собирает из них новый рецепт. Диагностику запускает `ghost doctor`.
Для кого. Для владельцев Mac, которые работают с Claude Code, Cursor или другим клиентом MCP и хотят поручить агенту действия в обычных приложениях, у которых нет API.
Подходит, если
- Нужно, чтобы агент отправил письмо в Gmail или сообщение в Slack, заполнив поля в окне браузера или приложения
- Одно и то же действие повторяется каждый день, и его надо записать один раз как рецепт, а дальше запускать с другими параметрами
- Веб-приложение плохо отдает элементы через дерево доступности, а нужно найти кнопку по картинке локальной моделью
- Вы хотите перед запуском прочитать каждый шаг: рецепты лежат обычными файлами JSON
Не подходит, если
- У вас Windows или Linux: Ghost OS работает только на macOS 14 и новее
- На диске мало места или Python не ставится: модель ShowUI-2B занимает около 3 ГБ, ее загрузку и установку пакетов выполняет `ghost setup`
- Нужен инструмент без доступа к вводу с клавиатуры и мыши: режиму обучения нужно разрешение «Мониторинг ввода», и он следит за вашими действиями
- Вы хотите автоматизировать только веб-страницы: для браузера есть специализированные серверы, например Playwright MCP
Пример запроса к агенту
Открой в Finder папку Документы и создай там папку «Отчеты октября», а потом скажи, что в ней видноMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Нужны macOS 14 или новее, права «Универсальный доступ» и «Запись экрана», а для режима обучения еще «Мониторинг ввода». Сборка из исходников требует Swift 6.2.
- Последний выпуск 2.2.1 вышел в марте 2026 года. Автор отмечает, что поиск полей в глубоких веб-приложениях может занимать около 11 секунд.
- Рецепт зависит от интерфейса: gmail-send рассчитан на Gmail в Chrome с нужным аккаунтом, а при смене разметки сайта шаги придется править.
- Установка прописывает сервер в `~/.claude.json` и разрешает все инструменты `mcp__ghost-os__*` в `~/.claude/settings.json`, поэтому Claude Code перестает спрашивать подтверждение на каждое действие.
- Лицензия MIT. Вы отвечаете за то, что агент делает от вашего имени в почте и мессенджерах.
Как отключить. Удалите запись `ghost-os` из `mcpServers` в `~/.claude.json` и строку `mcp__ghost-os__*` из `allowedTools` в `~/.claude/settings.json`. Затем выполните `brew uninstall ghost-os`. Рецепты, модель и среда Python лежат в `~/.ghost-os`, эту папку можно удалить целиком.
Частые вопросы
Что делает команда ghost setup?
Она по шагам проверяет права macOS, прописывает MCP-сервер в Claude Code, копирует рецепты из репозитория в `~/.ghost-os/recipes`, создает среду Python и скачивает модель ShowUI-2B. Если шаг не получился, мастер печатает команды для ручной установки.
Отправляет ли Ghost OS мои данные в облако?
Сам сервер работает на вашем Mac, а модель зрения запускается локально в помощнике на `localhost:9876`. Автор подчеркивает, что данные не покидают компьютер. Наружу уходит только то, что вы поручаете приложениям, например письмо через Gmail, и то, что ваш агент пересылает своей языковой модели.
Как научить Ghost OS новому сценарию?
Скажите агенту записать задачу. Он вызовет `ghost_learn_start`, вы выполните действия руками, а `ghost_learn_stop` вернет последовательность шагов с контекстом элементов. Агент превратит ее в рецепт с параметрами и сохранит через `ghost_recipe_save`.
Какие готовые рецепты есть в репозитории?
Четыре: `gmail-send` отправляет письмо в Chrome с параметрами получателя, темы и текста, `slack-send` пишет сообщение в Slack, `finder-create-folder` создает папку, `arxiv-download` ищет и скачивает статью с arXiv на рабочий стол.
Зачем нужна модель ShowUI-2B?
Она находит координаты элемента по картинке окна, когда дерево доступности не показывает его, как бывает в веб-приложениях. Инструменты `ghost_ground` и `ghost_parse_screen` обращаются к ней через помощника на Python. Для обычных приложений хватает дерева.
Как проверить, что установка прошла правильно?
Команда `ghost doctor` показывает построчно права, процессы, настройку MCP, число рецептов, читаемость дерева у запущенных приложений и наличие модели. Все строки должны быть отмечены как `ok`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
MCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
CLI на Rust для macOS: агент читает интерфейс любого приложения через дерево доступности и кликает, печатает, листает по ссылкам на элементы без скриншотов
Open Computer Use
open-computer-use
Открытый MCP-сервер для управления рабочим столом: агент читает состояние приложений и кликает, печатает, скроллит на macOS, Linux и Windows
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ghost OS (эта запись) | нет | не нужна | 1 681 | |
| Open Computer Use | нет | не нужна | 2 756 | открытый MCP-сервер управления рабочим столом на macOS, Linux и Windows |
| Windows-MCP | нет | не нужна | 10 682 | MCP-сервер для управления Windows, работает с файлами и PowerShell |
Коротко о README
В репозитории лежат исходники сервера на Swift по модулям (восприятие, действия, рецепты, обучение, зрение, MCP), мастер установки и диагностика, помощник на Python для модели зрения, четыре рецепта, справочник GHOST-MCP.md для агента и заметки о ходе работы. Главная страница начинается с обзора новой версии и сравнения с другими инструментами, затем идут установка, перечень инструментов и схема архитектуры.