cursortouch/macos-mcp

🍎 macOS-MCP

概要

macOS-MCPは、AIエージェントとmacOSオペレーティングシステムを橋渡しする軽量でオープンソースのモデルコンテキストプロトコルサーバーです。ファイルナビゲーション、アプリケーション制御、UIインタラクション、ブラウザ自動化**、システム操作などのタスクを通じて、LLMを通じてmacOSのシームレスな自動化を可能にします。

対応オペレーティングシステム

• macOS 12(モントレー)
• macOS 13(Ventura)
• 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