PH

prithviseran/hunch-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

23 stars 2 forks 품질 72 트렌드 31Apache-2.0

MCP: OS APIs, AppleScript, CDP 및 Accessibility를 통해 Mac 초점이 없는 드라이브

개요

Hunch는 Mac에서 LLM 에이전트 손을 제공하는 MCP 서버입니다. 설치된 앱, 로그 인 세션, 귀하의 파일, 화면을 넘지 않고. 이 땅에서 일하는 동안 에이전트는 배경 앱의 UI를 읽을 수 있으며, 버튼, 드라이브 메일 또는 음악 AppleScript, 웹 양식을 작성하거나 파일을 이동할 수 있습니다. 실제 네이티브 앱에서는 브라우저가 아닙니다. Hunch는 MCP 서버 지시로 상세한 재생책을 발송합니다; 공구 사용 모형 (Claude Sonnet/Opus 종류 및 위) 그것을 잘 따르십시오. 더 작은 모델은 clumsier 경로 (스크린 샷과 나무 대신 키 입력 및 클릭)를 선택할 수 있습니다. Hunch는 항상 가장 직접적인 층을 선호합니다. 그것은 빠르고, 더 믿을 수 있고, (마지막을 제외하고) 당신의 스크린을 결코 만지지 않습니다: 게이트 마지막 리조트 (screenshot + 좌표 clicks/keystrokes)은 접근 가능한 트리가 진정으로 비어있는 응용 프로그램에 대한 존재. 그것은 초점을 훔쳐, 그래서 먼저 물었다. Safari의 초점없는 시각적 작업은 web open(...

개요(AI 번역)

** 어떤 LLM으로 Mac을 드라이브 : MCP 이상 배경에서 초점없는. **

Hunch는 your에 LLM 에이전트 손을 제공하는 MCP 서버입니다. Mac: 설치된 앱, 당신의 로그인 세션, 화면을 넘지 않고 파일. 당신이 일하는 동안 전장, 에이전트는 배경 앱 UI를 읽을 수 있으며, 버튼, 드라이브 메일 또는 음악을 클릭 AppleScript, 웹 양식을 작성하거나 파일을 이동하십시오. 실제 네이티브 앱에서는 브라우저가 아닙니다.

현대 LLMs에서 최고의 작업. Hunch는 MCP 서버 지시로 상세한 재생책을 발송합니다; 가능한 공구 사용 모형 (Claude Sonnet/Opus 종류 및 위)는 그것을 잘 따릅니다. 소형 모델 clumsier 경로 (화면 및 나무 대신 키 입력 및 클릭).

4개의 층

Hunch는 항상 가장 직접적인 층을 선호합니다. 그것은 더 빠르고, 더 믿을 수 있고, (마지막을 제외하고) 당신의 스크린을 결코 만드십시오:

| 층 | 도구 | 그 외 | |—||||| |OS-API | trash file_op open_file [T3]] launch_app] … | 파일, 클립보드, 앱 라이프사이클, 직접 API 통화를 통해 | |AppleScript | [T5] | 스크립트 가능한 앱: 메일, 메시지, 메모, 캘린더, 음악, 찾기, 사파리 … |

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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

GitHub에서 전체 README 보기

설치

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

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →