Mac MCP
Локальный MCP-сервер для Mac: Claude, Codex и ChatGPT работают в приложениях, файлах, терминале и браузере по разрешениям
- 97 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Действует с правами вашего пользователя macOS: управляет приложениями, файлами, терминалом и браузером, видит открытые вкладки
- Прочитанное ИИ-приложением уходит его провайдеру, а запланированные задачи выполняются без вашего участия
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/bulutarkan/mac-mcp/main/install.sh | bashУстановщик для macOS 13 и новее. Для Apple Silicon и macOS 14 есть пакет .pkg в последнем релизе.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Действует с правами вашего пользователя macOS: управляет приложениями, файлами, терминалом и браузером, видит открытые вкладки
- Прочитанное ИИ-приложением уходит его провайдеру, а запланированные задачи выполняются без вашего участия
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mac MCP — локальный сервер и приложение в строке меню macOS, через которые ИИ-приложения (Claude, ChatGPT, Codex, OpenCode и другие клиенты MCP) действуют на вашем Mac. Приложения управляются через macOS Accessibility теми же кнопками и меню, что и у человека: Заметки, Finder, Почта. Доступны файлы и терминал. Автоматизация браузера в Safari и Chrome идет в фоновой вкладке, которую рамка подсвечивает, пока вы работаете дальше. Задачу можно передать другому агенту (Codex, Claude Code, OpenCode и семи другим CLI) и получить отчет. Выбранные папки индексируются локально, и ИИ-приложение отвечает по договорам, счетам и заметкам с указанием файла и страницы. Запланированные задачи запускают сценарии сами, а Recipes сохраняют сделанное ИИ и повторяют одним нажатием из Settings, приложения «Команды» или Siri. Версия 2.3.1 добавила Mac MCP Chat для работы с агентами в папке проекта. Права регулируются профилями разрешений, а необязательный Server Approval спрашивает подтверждение перед опасными действиями. Установка: пакет `.pkg` из релиза (Apple Silicon, macOS 14 и новее) или установщик для macOS 13 и новее. Клиент подключают командой `mac-mcp connect --client claude-desktop` (или `claude-code`, `codex`, `opencode`).
Для кого. Пользователям Mac, которые уже работают с Claude, Codex или ChatGPT и хотят, чтобы ИИ действовал в приложениях, файлах и браузере компьютера, а чат остался лишь пультом.
Подходит, если
- Нужно разобрать папку в Finder, открыть Заметки и составить черновик ответа в Почте
- Договоры и счета лежат в нескольких папках, и по ним нужны ответы с указанием файла и страницы
- Задачу ИИ стоит сохранить как рецепт и запускать из Siri или по расписанию
- Тесты и правки хочется поручить Codex или Claude Code на этом же Mac и прочитать их отчет
Не подходит, если
- Нужна изоляция: песочницы в Mac MCP нет, он действует с правами вашего пользователя macOS
- Работа идет на Windows или Linux: инструмент рассчитан на macOS 13 и новее
- На компьютере хранятся чужие конфиденциальные данные, которые нельзя передавать провайдеру ИИ: прочитанное уходит провайдеру выбранного ИИ-приложения
Пример запроса к агенту
Открой в Finder папку Договоры, найди в ней счета за октябрь и подготовь черновик письма бухгалтеру в Почте, не отправляя егоMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
MAC_MCP_API_KEYсекрет- Ключ для подключения клиентов по HTTP (Codex, OpenCode, Claude Code по сети)
MAC_MCP_CLI_SKILLS_DIRS- Список каталогов глобальных скиллов через двоеточие для их автоматического обнаружения
Ограничения
- Песочницы в Mac MCP нет: он действует с правами вашего пользователя macOS, а локальный адрес служит транспортом внутри машины и процессы одного пользователя не изолирует.
- Все, что ИИ-приложение прочитало, уходит провайдеру этого приложения.
- Пакет `.pkg` рассчитан на Apple Silicon и macOS 14 или новее и пока не нотаризован, поэтому при первом открытии нужен пункт Open Anyway в настройках приватности. Установщик подходит для macOS 13 и новее.
- Для ChatGPT нужен публичный адрес HTTPS (например Cloudflare Tunnel), режим Local only работает только для приложений на этом Mac.
Как отключить. Закройте приложение в строке меню и отключите клиент командой `mac-mcp connect` в настройках, либо удалите блок `mac-mcp` из конфигурации клиента. Порядок обновления и удаления описан в документации `docs/install.md`.
Частые вопросы
Как подключить Mac MCP к Claude Code или Codex?
Выполните `mac-mcp connect --client claude-code` (или `codex`, `opencode`, `claude-desktop`). Команда добавит Mac MCP как серверу, который запускает `mac-mcp stdio`, ключа и адреса в конфигурации не остается. Какие клиенты есть на Mac, покажет `mac-mcp clients`.
Как работает с ChatGPT?
ChatGPT подключается с серверов OpenAI, поэтому нужен публичный адрес HTTPS, например Cloudflare Tunnel или ngrok. Конфигурацию выдает `mac-mcp connect-config --client chatgpt`, а в режиме Local only ChatGPT подключить нельзя.
Как ограничить действия ИИ?
Профили разрешений определяют, какие инструменты доступны, а необязательный Server Approval просит подтверждение перед опасными действиями. Наблюдение можно приостановить, включить приватный режим или закрыть приложения и сайты от ИИ.
Какие агенты можно запускать из Mac MCP?
Задачу передают Codex, Claude Code, OpenCode и семи другим CLI, а Mac MCP Chat работает с Claude, Codex, OpenCode, GitHub Copilot, Antigravity, Kilo Code, Kimi Code, Goose и Cline.
Какие версии macOS поддерживаются?
Пакет `.pkg` рассчитан на Apple Silicon и macOS 14 или новее, а установщик (`install.sh` или `npx @bulutarkan/mac-mcp install`) подходит для macOS 13 и новее на Apple Silicon и Intel.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер для Mac и Windows: агент работает с почтой, мессенджерами, календарем и файлами.
MCP-сервер для macOS: агент читает, ищет и отправляет сообщения в приложении Сообщения на вашем Mac
Плагин и MCP-сервер Macuse открывают агенту Календарь, Почту, Заметки и Сообщения на Mac, а также управление любой программой
MCP-сервер и приложение для Mac: один локальный индекс репозиториев, сессий агентов и задач, поиск по смыслу и нити работы
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
Коротко о README
В README названы пять сильных сторон: работа внутри приложений через Accessibility, видимая автоматизация браузера, передача задач другим агентам, ответы по документам и автоматизация повторов. Дальше идут быстрая установка, новости версии 2.3.1 (Mac MCP Chat), навигация по документации, синхронизация Agent Skills из каталогов CLI-агентов, раздел о безопасности и разработке.