
prithviseran/hunch-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP:OS API、AppleScript、CDP、およびアクセシビリティを介したMacのフォーカスフリードライブ
概要
Hunchは、お使いのMac上でLMエージェントの手を渡すMCPサーバーです。インストールされたアプリ、ログインしたセッション、ファイル、画面を占有することなく。 フォアグラウンドで作業を続けながら、エージェントはバックグラウンドアプリのUIを読んだり、ボタンをクリックしたり、AppleScriptでメールや音楽を操作したり、Webフォームを記入したり、ファイルを移動したりすることができます。 ブラウザだけでなく、実際のネイティブアプリで動作します。 Hunch は、MCP サーバーの指示として詳細な Playbook を出荷します。 利用可能なツール使用モデル (Claude Sonnet/Opus-class と up) が適切に続きます。 より小さいモデルは、ツリーの読み込みとクリックの代わりに、クムシエのパス(スクリーンショットとキーストローク)を選ぶことができます。 常に最も直接層を好むハンチ。 それはより速く、より信頼でき、(最後のを除く)あなたのスクリーンに触れません: アクセシビリティツリーが本当に空いているアプリには、ゲートされた最後のリゾート(スクリーンショット+座標クリック/キーストローク)が存在します。 それは焦点を盗むので、最初に尋ねます。 Safari でフォーカスフリーのビジュアルワークのために、Web open で専用の拡張所有ウィンドウを開きます.
概要(AI 翻訳)
あらゆるLMであなたのMacを運転して下さい:MCP上の背景で、焦点なし、。
Hunch は、LM エージェントのハンドを your に提供する MCP サーバーです。 Mac:インストールしたアプリ、 ログオンセッション、ファイル、画面を上回らない あなたが働いている間 背景アプリのUIを読んで、ボタンをクリックし、メールや音楽を操作できます。 AppleScript は、Web フォームを埋めたり、ファイルを移動したりします。 ブラウザだけでなく、実際のネイティブアプリで動作します。
現代LLMで最高の仕事 Hunch は MCP サーバーの指示として詳細な Playbook を出荷します。 対応するツールモデル(クラウド・ソンネット/オパスクラスとアップ)がうまくいきます。 小さいモデルはかもしれないかもしれません clumsierパス(ツリーの読み込みとクリックの代わりにスクリーンショットとキーストローク)を選択します。
4つのレイヤー
常に最も直接層を好むハンチ。 より速く、より信頼性があり、(最後のものを除く) 決してあなたのスクリーンに触れないで下さい:
| レイヤー | ツール | お問い合わせ |
お問い合わせ
|OS-API | trash [file_op] [[open_file]] [[clipboard_*]]]]]…
|AppleScript | [applescript | スクリプト可能なアプリ: メール、メッセージ、ノート、カレンダー、音楽、ファインダー、サファリ… |
このページは 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
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →