PH

prithviseran/hunch-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

23 stars 2 forks Качество 72 Тренд 31Apache-2.0

Drive your Mac focus-free over MCP: OS API, AppleScript, CDP и Accessibility

Обзор

Hunch - это MCP-сервер, который дает агенту LLM доступ к вашему Mac: установленные приложения, сеансы входа в систему, файлы, не захватывая экран. Пока вы продолжаете работать на переднем плане, агент может читать пользовательский интерфейс фонового приложения, нажимать на его кнопки, управлять почтой или музыкой с помощью AppleScript, заполнять веб-форму или перемещать файлы. Он работает на реальных нативных приложениях, а не только на браузере. Hunch поставляет подробный сценарий в виде инструкций сервера MCP; модели, использующие инструменты (Claude Sonnet / Opus-class и выше), хорошо следуют ему. Меньшие модели могут выбирать более неуклюжие пути (снимки экрана и нажатия клавиш вместо чтения деревьев и щелчков). Хунч всегда предпочитает самый прямой слой. Он быстрее, надежнее и (кроме последнего) никогда не касается экрана: Закрытый крайний вариант (снимок экрана + координатные щелчки / нажатия клавиш) существует для приложений, дерево доступности которых действительно пусто. Он крадет фокус, поэтому сначала спрашивает тебя. Для бесфокусной визуальной работы в Safari откройте специальное окно с web open.

Обзор (машинный перевод)

** Водите Mac с любым LLM: без фокусировки, в фоновом режиме, по MCP.**

Hunch - это MCP-сервер, который дает LLM-агенту доступ к your Mac: установленные приложения, ваши Зарегистрированные сессии, ваши файлы, не захватывая экран. Пока вы продолжаете работать в На переднем плане агент может читать пользовательский интерфейс фонового приложения, нажимать на его кнопки, управлять почтой или музыкой. AppleScript, заполните веб-форму или переместите файлы. Он работает на реальных нативных приложениях, а не только на браузере.

** Лучше всего работает с современными LLM.** Hunch отправляет подробный сценарий в виде инструкций сервера MCP; Способные модели использования инструментов (Claude Sonnet/Opus-class и выше) следуют за ним хорошо. Маленькие модели могут

выбрать неуклюжие дорожки (снимки экрана и нажатия клавиш вместо чтения и щелчков дерева).

Четыре слоя

Хунч всегда предпочитает самый прямой слой. Он быстрее, надежнее и (кроме последнего) Никогда не касайтесь экрана:

Слой, инструменты. Что это такое для [править править код] | OS-API | trash file_op open_file clipboard_* … | файлы, буфер обмена, жизненный цикл приложения через прямые вызовы API | | AppleScript | applescript | скриптовые приложения: Mail, Messages, Notes, Calendar, Music, Finder, Safari… |

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Hunch

Drive your Mac with any LLM: focus-free, in the background, over MCP.

Hunch is an MCP server that gives an LLM agent hands on your Mac: your installed apps, your logged-in sessions, your files, without taking over your screen. While you keep working in the foreground, an agent can read a background app’s UI, click its buttons, drive Mail or Music by AppleScript, fill a web form, or move files. It works on real native apps, not just a browser.

Works best with modern LLMs. Hunch ships a detailed playbook as MCP server instructions; capable tool-using models (Claude Sonnet/Opus-class and up) follow it well. Smaller models may pick clumsier paths (screenshots and keystrokes instead of tree reads and clicks).

The four layers

Hunch always prefers the most direct layer. It’s faster, more reliable, and (except the last) never touches your screen:

Layer Tools What it’s for
OS-API trash file_op open_file clipboard_* launch_app … files, clipboard, app lifecycle, via direct API calls
AppleScript applescript scriptable apps: Mail, Messages, Notes, Calendar, Music, Finder, Safari …
Web web_open web_snapshot web_act web_login … Safari through the bundled extension, or Chromium/Electron through CDP, driven in the background
Accessibility snapshot act any native app’s UI: read the tree, click/select/type by reference

A gated last resort (screenshot + coordinate clicks/keystrokes) exists for apps whose accessibility tree is truly empty. It steals focus, so it asks you first.

For focus-free visual work in Safari, open a dedicated extension-owned window with web_open(..., app="Safari", new_window=True). web_screenshot captures that background window, and web_act can use the returned pixel coordinates without moving the shared mouse, keyboard, or foreground window. The extension remains necessary: it owns the isolated Safari window and dispatches renderer-local actions that a physical screen capture cannot.

How it works (no server, no cloud)

“MCP server” undersells how local this is. hunch serve is a plain Python process that your MCP host (Claude Desktop, Cursor, …) spawns as a child process and talks to over JSON-RPC on stdin/stdout (MCP’s stdio transport). There is no HTTP endpoint, no port Hunch listens on, no daemon, and no telemetry. When your host quits, Hunch is gone.

The tools are direct macOS API calls in-process: the Accessibility framework via pyobjc, osascript for AppleScript, OS APIs for files/clipboard, a local WebSocket to Chromium’s DevTools port, and the signed local Safari extension bridge. The optional Safari companion

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →