cursortouch/macos-mcp

🍎 macOS-MCP

개요

macOS-MCP는 AI 에이전트와 macOS 운영체제를 연결하는 가벼운 오픈소스 모델 컨텍스트 프로토콜 서버입니다. 파일 탐색, 애플리케이션 제어, UI 상호작용, 브라우저 자동화**, 시스템 운영과 같은 작업을 통해 LLM을 통한 macOS의 원활한 자동화를 가능하게 합니다.

지원되는 운영체제

• macOS 12 (몬터레이)
• macOS 13 (벤투라)
• macOS 14 (소노마)
• macOS 15 (세쿼이아)
• macOS 26 (타호)

주요 특징

• 모든 LLM과 함께 작동 (비전 선택 사항) 전통적인 자동화 도구와 달리 macOS-MCP는 컴퓨터 비전, 미세 조정된 모델, 특수 설정이 필요하지 않습니다. Claude, GPT, Gemini 등 어떤 LLM과도 원활하게 작동합니다.

• 네이티브 macOS 통합
  접근성 API를 통해 macOS UI 요소와 네이티브로 상호작용할 수 있습니다. 앱을 열고, 창을 제어하며, 사용자 입력을 시뮬레이션하고, 우회 방법 없이 데스크톱 상태를 캡처합니다.

• 자동화를 위한 풍부한 도구 세트
  키보드/마우스 조작, 창 관리, UI 상태 캡처, 접근성 트리에서의 인터랙티브 요소 추출, AppleScript 실행을 위한 완전한 툴킷입니다.

• 경량 및 오픈 소스

Overview

macOS-MCP is a lightweight, open-source Model Context Protocol server that bridges AI agents and the macOS operating system. It enables seamless automation of macOS through LLMs via tasks such as file navigation, application control, UI interaction, browser automation, and system operations.

Supported Operating Systems

• macOS 12 (Monterey)
• macOS 13 (Ventura)
• macOS 14 (Sonoma)
• macOS 15 (Sequoia)
• macOS 26 (Tahoe)

Key Features

• Works with Any LLM (Vision Optional)
  Unlike traditional automation tools, macOS-MCP doesn’t require computer vision, fine-tuned models, or specialized setup. Works seamlessly with any LLM—Claude, GPT, Gemini, or others.

• Native macOS Integration
  Interacts natively with macOS UI elements using the Accessibility API. Opens apps, controls windows, simulates user input, and captures desktop state without workarounds.

• Rich Toolset for Automation
  Complete toolkit for keyboard/mouse operations, window management, UI state capture, interactive element extraction from the accessibility tree, and AppleScript execution.

• Lightweight and Open-Source
  Minimal dependencies with full source code available under MIT license. Easy setup and deployment.

• Smart Context Awareness
  Automatically detects application state (Launchpad, Control Center, Spotlight). Scans menu bar, dock, desktop, and system UI elements intelligently.

• Customizable and Extensible
  Easily extend with custom tools or modify behavior to suit your specific automation needs.

Installation

Prerequisites

• Python: 3.11 or later
• UV Package Manager: Install with pip install uv or curl -LsSf https://astral.sh/uv/install.sh | sh
• macOS: 12 (Monterey) or later
• Accessibility Permissions: Required for UI element interaction

Quick Start

Run the server directly:

uvx macos-mcp serve

# Or with SSE/Streamable HTTP for network access
uvx macos-mcp serve --transport sse --host localhost --port 8000
uvx macos-mcp serve --transport streamable-http --host localhost --port 8000

Run it as a background service that starts now and at every login:

macos-mcp install

# Or choose the HTTP transport and bind address explicitly
macos-mcp install --transport sse --host 127.0.0.1 --port 8000