plonk — MCP-сервер для Claude Code: что делает и как установить
Связывает ИИ-агента с оконным менеджером Plonk на macOS. Позволяет расставлять окна по сетке, делать скриншоты, распознавать текст на экране и сохранять рабочие столы.
claude mcp add plonk -- npx -y plonk-mcpЧто делает plonk
Пакет plonk-mcp служит мостом к одноимённой утилите в строке меню macOS 13+. Без запущенного приложения Plonk любой вызов инструмента вернёт ошибку. Для работы нужен Node 18+, а саму программу ставят через Homebrew командой brew install --cask ostapondo/plonk/plonk.
Инструменты сервера дают агенту прямой доступ к окружению рабочего стола. Модель считывает расположение окон через get_state, делит экран на доли от 0 до 1, привязывает программы к зонам и запускает сохранённые рабочие пространства. Инструмент extract_text находит слова на экране без отправки картинок во внешние сервисы, а take_screenshot умеет снимать скрытые окна без вывода их на передний план.
Связь между сервером и приложением идёт локально по адресу 127.0.0.1:43917 с проверкой ключа из файла ~/Library/Application Support/Plonk/token. Поэтому агент и Plonk обязаны работать под одной учётной записью macOS.
Какие задачи решает
- расставить открытые окна по долям экрана
- сохранить текущий рабочий стол и восстановить его позже
- сделать скриншот скрытого окна конкретного приложения
- распознать текст с экрана через локальный OCR
- заблокировать переход системы в спящий режим
Примеры запросов агенту
- Сделай скриншот окна браузера и найди ошибки в верстке
- Размести окно терминала в правой половине экрана, а редактор слева
- Сохрани текущее расположение окон как рабочее пространство review
Как установить plonk
Командой платформы
claude mcp add plonk -- npx -y plonk-mcpКомандой платформы
codex mcp add mcp -- npx -y plonk-mcpФайл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"plonk-mcp"
]
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"plonk-mcp"
]
}
}
}Командой платформы
gemini mcp add mcp npx -y plonk-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о plonk
Как установить plonk в Claude Code?
Сначала установите приложение через Homebrew: brew install --cask ostapondo/plonk/plonk и запустите его. Затем добавьте сервер в клиент командой claude mcp add plonk -- npx -y plonk-mcp.
Что делает MCP-сервер plonk?
Он предоставляет агенту набор команд для управления окнами на мониторах Mac, чтения экранного текста и создания аннотированных скриншотов. Все операции выполняются локально через связку с приложением Plonk.
Какие системные права нужны для работы plonk?
Программе требуется доступ к Универсальному доступу (Accessibility) в настройках macOS, после чего приложение нужно один раз перезапустить. Для захвата экрана система также запросит разрешение Screen Recording при первом скриншоте.
