Remote macOS Use — управление удаленным Mac
mcp-remote-macos-use
MCP-сервер, через который Claude Desktop видит экран Mac по VNC, двигает мышь, жмет клавиши и открывает приложения
- 490 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает полный экран, мышь и клавиатуру удаленного Mac и может сделать на нем все, что может пользователь
- Пароль учетной записи Mac передается в переменной окружения и хранится в конфигурации клиента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-remote-macos-useОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает полный экран, мышь и клавиатуру удаленного Mac и может сделать на нем все, что может пользователь
- Пароль учетной записи Mac передается в переменной окружения и хранится в конфигурации клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к Mac по VNC, то есть через штатный режим «Общий экран», и передает агенту картинку экрана. Дополнительное ПО на целевом компьютере не нужно: достаточно включить общий доступ к экрану. Агент смотрит на снимок и решает, куда нажать. Управление собрано из восьми инструментов: remote_macos_get_screen, remote_macos_mouse_move, remote_macos_mouse_click, remote_macos_mouse_double_click, remote_macos_mouse_drag_n_drop, remote_macos_mouse_scroll, remote_macos_send_keys и remote_macos_open_application. Серверу не нужен отдельный ключ модели: картинки обрабатывает та модель, с которой вы уже работаете в Claude Desktop. Сервер запускается в контейнере Docker. Адрес, имя пользователя и пароль Mac передаются переменными окружения. По желанию подключается WebRTC через LiveKit, он дает меньшую задержку, чем VNC.
Для кого. Для тех, кто работает в Claude Desktop и хочет дать агенту доступ к своему или арендованному Mac: проверить интерфейс, пройти сценарий в приложении, где нет API.
Подходит, если
- Нужно выполнить сценарий в приложении macOS, у которого нет API и командной строки
- Mac арендован в облаке: README отдельно отмечает, что для арендованного Mac включать общий экран не нужно, если провайдер уже его включил
- Задача требует посмотреть, как выглядит экран, а не прочитать файл или вывод команды
- Хочется управлять другим компьютером из Claude Desktop без установки агентской программы на нем
Не подходит, если
- Приложение управляется через API или командную строку: скрипт надежнее, чем щелчки по картинке
- Нужны Windows или Linux: сервер рассчитан на macOS
- На Mac лежат пароли, платежные данные и рабочая почта, которые агент не должен видеть: он получает весь экран
- Нужна высокая скорость: автор сам называет производительность первым пунктом списка доработок
Пример запроса к агенту
Подключись к моему Mac, открой Notes и опиши, что видно на экранеMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
MACOS_HOSTобязательная- Адрес или имя хоста Mac
MACOS_PASSWORDобязательная, секрет- Пароль учетной записи Mac для входа по VNC
MACOS_USERNAME- Имя пользователя Mac
MACOS_PORT- Порт VNC, по умолчанию 5900
VNC_ENCRYPTION- Режим шифрования VNC, по умолчанию prefer_on
LIVEKIT_URL- Адрес LiveKit для WebRTC
LIVEKIT_API_KEYсекрет- Ключ LiveKit
LIVEKIT_API_SECRETсекрет- Секрет LiveKit
Ограничения
- Для запуска нужны MACOS_HOST и MACOS_PASSWORD, без них сервер завершается с ошибкой. Пароль учетной записи Mac попадает в конфигурацию клиента.
- Нужен Docker Desktop на локальном Mac или другом компьютере, где запускается сервер.
- Последнее изменение в репозитории датировано июнем 2025 года.
- Автор перечисляет в планах улучшение скорости, генерацию AppleScript для ускорения и видимый курсор VNC, поэтому ожидайте задержек.
Как отключить. Удалите блок `remote-macos-use` из claude_desktop_config.json и перезапустите Claude Desktop. Общий экран на Mac отключают в системных настройках в разделе «Общий доступ».
Частые вопросы
Что нужно включить на Mac для работы `remote-macos-use`?
Общий доступ к экрану: сервер подключается по VNC на порт 5900 по умолчанию. Если Mac арендован у MacStadium, шаг можно пропустить, как отмечает README.
Зачем здесь LiveKit?
WebRTC через LiveKit дает передачу экрана с малой задержкой и подстройкой качества под сеть. Для включения нужны LIVEKIT_URL, LIVEKIT_API_KEY и LIVEKIT_API_SECRET, без них сервер работает по VNC.
Нужен ли отдельный ключ API модели?
Нет. По описанию автора экран обрабатывает модель из вашей подписки на Claude, отдельный ключ не требуется.
Как запустить сервер без Docker?
В репозитории есть pyproject.toml с зависимостями и пакет src/mcp_remote_macos_use, но документация показывает только запуск образа Docker. Другие способы запуска автор не документирует.
Какие действия агент выполняет на удаленном Mac?
Получает снимок экрана, двигает указатель, нажимает и дважды нажимает кнопку мыши, перетаскивает, прокручивает, отправляет клавиши и открывает приложение по имени.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Open Computer Use
open-computer-use
Открытый MCP-сервер для управления рабочим столом: агент читает состояние приложений и кликает, печатает, скроллит на macOS, Linux и Windows
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
MCP-сервер дает агенту управлять окнами и приложениями: он читает экран как структуру и действует по имени элемента
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
MCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Remote macOS Use — управление удаленным Mac (эта запись) | нет | API-ключ | 490 | |
| Peekaboo | нет | не нужна | 5 405 | CLI и MCP для локальных снимков экрана и разбора интерфейса через accessibility |
| Open Computer Use | нет | не нужна | 2 756 | MCP управления рабочим столом на том же компьютере, без VNC |
Коротко о README
README показывает сценарии, которые автор проверил: исследование и публикация в Twitter, монтаж короткого ролика в CapCut, сбор данных кандидатов через почту и вовлечение в LinkedIn. Затем идут схема архитектуры, пошаговая установка с включением общего экрана и блок конфигурации для Claude Desktop. Отдельный раздел описывает WebRTC и список доработок, ниже приведены команды сборки образа Docker и публикации для нескольких платформ.