cursortouch/macos-mcp

🍎 macOS-MCP

Обзор

macOS-MCP — это лёгкий сервер с открытым исходным кодом Model Context Protocol, который объединяет AI-агенты и операционную систему macOS. Он обеспечивает бесшовную автоматизацию macOS через LLM с помощью таких задач, как навигация по файлам, управление приложениями, взаимодействие с интерфейсом, автоматизация браузера** и системные операции.

Поддерживаемые операционные системы

• macOS 12 (Монтерей)
• macOS 13 (Ventura)
• macOS 14 (Sonoma)
• macOS 15 (Sequoia)
• macOS 26 (Тахо)

Ключевые особенности

• Работает с любым LLM (Visual Optional) В отличие от традиционных инструментов автоматизации, macOS-MCP не требует компьютерного зрения, тонко настроенных моделей или специализированной настройки. Работает бесшовно с любым LLM — Claude, GPT, Gemini и другими.

• Нативная интеграция с macOS
  Взаимодействует нативно с элементами интерфейса macOS через API доступности. Открывает приложения, управляет окнами, имитирует ввод пользователя и фиксирует состояние рабочего стола без обходных решений.

• Богатый набор инструментов для автоматизации
  Полный набор инструментов для операций с клавиатурой и мышью, управления окнами, захвата состояния интерфейса, интерактивного извлечения элементов из дерева доступности и выполнения 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