macOS-MCP — MCP-сервер для Claude Code: автоматизация macOS
MCP-сервер, через который агент управляет macOS: открывает приложения, кликает по элементам интерфейса, снимает состояние экрана.
claude mcp add macos-mcp -- uvx macos-mcpЧто делает macOS-MCP
macOS-MCP соединяет ИИ-агента с рабочим столом macOS через Accessibility API. Агент открывает приложения, управляет окнами, имитирует клавиатуру и мышь, забирает список интерактивных элементов из дерева доступности и выполняет AppleScript. Скриншоты для инструмента Snapshot берутся через Screen Recording. Компьютерное зрение не нужно: сервер отдаёт агенту структуру интерфейса, а не картинку.
Запуск без установки — uvx macos-mcp в режиме stdio, либо с транспортом sse или streamable-http на localhost и порту. Команда macos-mcp install ставит Launch Agent в ~/Library/LaunchAgents/com.macos-mcp.server.plist, чтобы сервер поднимался при входе в систему; логи ложатся в ~/.macos-mcp/. Транспорты sse и streamable-http дают доступ по сети, а не только с этой машины.
Нужны Python 3.11 или новее, UV и macOS 12+. Без разрешений Accessibility и Screen Recording в «Системных настройках» инструменты упрутся в отказ: выдавать их надо терминалу, Python и UV, после чего терминал перезапустить. Если интерпретатор из-под UV не добавляется в список вручную, запустите сервер — он сам вызовет AXIsProcessTrustedWithOptions и покажет системный запрос.
Какие задачи решает
- открыть приложение и переключиться на нужное окно из агента
- снять список кликабельных элементов окна вместо разбора скриншота
- выполнить AppleScript по просьбе агента в чате
- поднять сервер автоматизации в фоне при входе в систему
Примеры запросов агенту
- Открой Finder и перейди в папку
~/Projects, покажи, что в ней лежит - Сделай снимок экрана и опиши, какое окно сейчас активно
- Запусти AppleScript, который закрывает все окна Safari
Как установить macOS-MCP
Командой платформы
claude mcp add macos-mcp -- uvx macos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from macos-mcp <команда>
Командой платформы
codex mcp add macos-mcp -- uvx macos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from macos-mcp <команда>
Файл настроек
{
"mcpServers": {
"macos-mcp": {
"command": "uvx",
"args": [
"macos-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from macos-mcp <команда>
Файл настроек
{
"servers": {
"macos-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"macos-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from macos-mcp <команда>
Командой платформы
gemini mcp add macos-mcp uvx macos-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from macos-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о macOS-MCP
Как установить macOS-MCP в Claude Code?
Выполните claude mcp add macos-mcp -- uvx macos-mcp. Перед этим поставьте UV и Python 3.11+, а после добавления выдайте Accessibility и Screen Recording.
Что делает macOS-MCP?
Даёт агенту инструменты для работы с интерфейсом macOS: управление окнами и приложениями, клики и ввод, чтение дерева доступности, AppleScript и снимки экрана.
Почему инструменты macOS-MCP не срабатывают?
Скорее всего, не выданы разрешения Accessibility или Screen Recording — их получают терминал, Python и UV, затем терминал перезапускают. Для снимков экрана нужен Screen Recording.
