건강. 이것은 매우 위험한 도구입니다.

# # DEFINITION에 의해, 이것은 당신의 MAC을 할 수있는 능력 LLM을 GIVING입니다. 당신으로.

THINK LONG AND HARD 당신이 YOLO에 데크와 할 수있는 MAC에 그것을 실행 …

⚠️ ** 중요 사항** ⚠️

• **이 프로젝트는 더 나은 이름을 필요로 ** - "MacMCP"는 placeholder입니다.
• ** 크게 생산에서 테스트 ** - 자신의 위험에 사용
• 이 README는 LLM에 의해 작성되었습니다. - 내용이 부정하거나 불완전 할 수 있습니다.
• **Caveat emptor ** - 구매자는주의와 사용

MacMCP는 MacMCP의 모델 Context Protocol (MCP) 서버로, macOS Accessibility API를 stdio 프로토콜을 통해 대용량 모델(LLMs)에 노출합니다. Claude와 같은 LLMs는 사용자가 사용할 수있는 동일한 접근성 API를 사용하여 macOS 애플리케이션과 상호 작용할 수 있으며 웹을 탐색하고 프레젠테이션을 만들고 스프레드 시트를 사용하거나 메시징 응용 프로그램을 사용하여 사용자 수준의 작업을 수행 할 수 있습니다.

특징

핵심 능력

• UI Exploration: macOS 애플리케이션 인터페이스를 발견하고 분석
• UI Interaction: UI 요소로 클릭, 유형, 스크롤 및 상호 작용

MacMCP - macOS Accessibility Model Context Protocol Server

HEADS UP. THIS IS AN INCREDIBLY DANGEROUS TOOL.

BY DEFINITION, THIS IS GIVING AN LLM THE ABILITY TO DO ANYTHING YOUR MAC CAN DO. AS YOU.

THINK LONG AND HARD BEFORE YOU DECIDE TO YOLO AND RUN IT ON A MAC THAT HAS PERMISSION TO DO…ANYTHING.

⚠️ IMPORTANT DISCLAIMERS ⚠️

• This project needs a better name - “MacMCP” is a placeholder
• Largely untested in production - Use at your own risk
• This README was written by an LLM - Content may be inaccurate or incomplete
• Caveat emptor - Buyer beware, use with caution

MacMCP is a Model Context Protocol (MCP) server that exposes macOS accessibility APIs to Large Language Models (LLMs) over the stdio protocol. It enables LLMs like Claude to interact with macOS applications using the same accessibility APIs available to users, allowing them to perform user-level tasks such as browsing the web, creating presentations, working with spreadsheets, or using messaging applications.

Features

Core Capabilities

• UI Exploration: Discover and analyze macOS application interfaces
• UI Interaction: Click, type, scroll, and interact with UI elements
• Screenshot Capture: Take screenshots of the screen or specific UI elements
• Application Management: Launch and manage macOS applications
• Window Management: Move, resize, minimize, and maximize application windows
• Menu Navigation: Navigate application menus and activate menu items
• Keyboard Interaction: Execute keyboard shortcuts and type text
• Clipboard Management: Manage clipboard content including text and images

Accessibility Tools

• Interface Explorer: Enhanced UI exploration with state and capabilities information
• Screenshot Tool: Capture screenshots for visual context
• UI Interaction Tool: Perform precise UI interactions
• Application Tool: Open and manage applications
• Window Management Tool: Control window positioning and state
• Menu Navigation Tool: Access application menu systems
• Keyboard Tool: Send keyboard input and shortcuts
• Clipboard Tool: Read and write clipboard content

Requirements

• macOS: 13.0 or later
• Swift: 6.1 or later
• Accessibility Permissions: Required for UI interaction functionality

Installation

Building from Source

1. Clone the repository:

   git clone 
   cd MacMCP
   

2. Build the project:

   swift build
   

3. Build for release (recommended for production):

   swift build -c release
   

Grant Accessibility Permissions

MacMCP requires accessibility permissions to interact with UI elements:

1. Open System Settings > Privacy & Security > Accessibility
2. Add the MacMCP executable to the list of allowed applications
3. Verify permissions with:

   swift run check_permissions
   

Usage

Running the Server