hunch — MCP-сервер для Claude Code: что делает и как установить
Управляет macOS и нативными приложениями в фоне без перехвата курсора и потери фокуса окна. Пригодится для тихой автоматизации рутины прямо во время работы.
claude mcp add hunch -- uvx hunch-sdkЧто делает hunch
Hunch запускается как локальный дочерний процесс хоста через stdio JSON-RPC. Он не открывает сетевых портов. Никаких демонов и внешних облаков нет. Для взаимодействия с системой сервер задействует четыре уровня: системные вызовы OS-API для файлов, osascript для программ вроде Mail, работу с браузерами через CDP или локальное расширение Safari, а также чтение дерева Accessibility для нажатий по элементам интерфейса.
Для работы требуется macOS 13 или новее. Доступ в системном разделе «Универсальный доступ» (Accessibility) нужно выдать не самому серверу, а запускающему приложению — вашему терминалу или среде разработки. Запись экрана нужна только как запасной вариант для приложений с пустым деревом доступности.
Какие задачи решает
- нажимать кнопки и считывать интерфейс запущенных программ без смещения фокуса
- управлять почтой, заметками или плеером через вызовы AppleScript
- открывать изолированные фоновые вкладки в Safari или браузере на базе Chromium
- удалять и перемещать файлы в корзину через прямые системные вызовы
Примеры запросов агенту
- Проверь новые входящие сообщения в
Mailи кратко перескажи их - Открой в фоне вкладку Safari с репозиторием и сделай снимок содержимого
- Найди в окне Notes заметку с планом на неделю и скопируй её текст
Как установить hunch
Командой платформы
claude mcp add hunch -- uvx hunch-sdkuvx запускает команду с именем пакета; если в README она другая — uvx --from hunch-sdk <команда>
Командой платформы
codex mcp add hunch -- uvx hunch-sdkuvx запускает команду с именем пакета; если в README она другая — uvx --from hunch-sdk <команда>
Файл настроек
{
"mcpServers": {
"hunch": {
"command": "uvx",
"args": [
"hunch-sdk"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from hunch-sdk <команда>
Файл настроек
{
"servers": {
"hunch": {
"type": "stdio",
"command": "uvx",
"args": [
"hunch-sdk"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from hunch-sdk <команда>
Командой платформы
gemini mcp add hunch uvx hunch-sdkuvx запускает команду с именем пакета; если в README она другая — uvx --from hunch-sdk <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о hunch
Как установить hunch в Claude Code?
Выполните команду claude mcp add hunch -- uvx hunch-sdk. Затем перезапустите агент и проверьте доступность инструментов.
Зачем нужен hunch?
Сервер даёт модели доступ к интерфейсу macOS без захвата экрана. Агент обращается к дереву элементов Accessibility и системным API, поэтому активное окно и курсор остаются в вашем распоряжении.
Какие разрешения требуются в macOS?
Понадобится macOS 13+. Разрешение Accessibility выдаётся родительскому приложению (терминалу или IDE), а запросы Automation подтверждаются в диалоге один раз для каждой управляемой программы.
