Communitygithub.com

macOS 제어 — AI Mac 자동화

MCP 서버를 통해 AI가 macOS를 직접 제어할 수 있도록 합니다. 앱 실행, 디스플레이 설정, 오디오 제어, 파일 검색, 스크린샷, 클립보드 관리를 자연어로 수행합니다.

macOS 제어 — AI Mac 자동화란 무엇인가요?

이 MCP 기반 스킬은 Claude와 같은 AI 에이전트가 macOS 운영체제를 직접 제어할 수 있는 15개의 도구를 제공합니다. 사용자는 자연어 명령만으로 앱 실행/종료, 다크 모드 전환, 볼륨 조절, 시스템 알림 전송, Spotlight 파일 검색, 스크린샷 촬영, 클립보드 읽기/쓰기 등을 수행할 수 있습니다. Python 표준 라이브러리만으로 구현되어 무료이며, 외부 API 호출이 없고 모든 명령에 타임아웃이 설정되어 있어 안전하게 사용할 수 있습니다. 현재는 macOS에 국한되어 있지만 ghost-browser, google-mcp, instantly-campaigns 등 다른 MCP 서버와 결합하여 브라우저 자동화, 이메일 첨부, 템플릿 관리 등 더 복잡한 워크플로우를 구성할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/mac-control

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

macOS 제어 — AI Mac 자동화은(는) 무엇을 하나요?

Claude가 15개의 MCP 도구를 통해 Mac을 직접 제어할 수 있습니다. 앱 실행, 다크 모드 전환, 파일 검색, 스크린샷 촬영, 클립보드 관리 등 모든 작업을 자연어로 수행합니다.

위치

프로젝트: /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/ MCP 서버: Mac-Automation/macos_mcp.py

도구 참조

시스템 (읽기 전용)

get_system_info()                    # macOS 버전, 칩, RAM, 가동 시간
get_running_apps()                   # 모든 보이는 실행 중인 앱
get_disk_usage()                     # 볼륨별 저장 공간

앱 제어

open_app(app_name="Safari")          # 앱 실행 (/Applications/에서 검증)
close_app(app_name="Notes")          # AppleScript로 정상 종료
switch_to_app(app_name="Terminal")   # 포그라운드로 전환

디스플레이 및 오디오

toggle_dark_mode()                   # 라이트/다크 모드 전환 (즉시 시각적 변경)
set_volume(level=50)                 # 0-100, 자동 음소거 해제

알림

send_notification(title="안녕하세요", message="수업 시작합니다!", sound="Glass")
play_sound(sound_name="Ping")        # 14가지 시스템 사운드 사용 가능

파일 및 검색

spotlight_search(query="invoice.pdf", folder="~/Documents", limit=20)
open_folder(folder_path="~/Desktop") # Finder에서 열기

클립보드

get_clipboard()                      # 현재 클립보드 읽기
set_clipboard(text="Hello World")    # 클립보드에 쓰기

스크린샷

take_screenshot(region="full")       # 전체 화면 PNG를 바탕화면에 저장
take_screenshot(region="window")     # 전면 창만 캡처

스키마

입력

이름유형필수설명
app_namestr상황에 따라 다름.app 없이 앱 이름 (예: 'Safari')
levelint상황에 따라 다름볼륨 0-100
titlestr상황에 따라 다름알림 제목
messagestr상황에 따라 다름알림 내용
soundstr아니요사운드 이름 (default/Glass/Ping/Pop 등)
querystr상황에 따라 다름Spotlight 검색어
folderstr아니요검색 범위 폴더
textstr상황에 따라 다름클립보드 텍스트
regionstr아니요스크린샷 영역 (full/window)

출력

이름유형설명
resultstr사람이 읽을 수 있는 결과 또는 오류 메시지

자격 증명

이름유형필수설명
(없음)——자격 증명 불필요 — 로컬 macOS 명령어 사용

함께 구성 가능한 서비스

  • ghost-browser — 스크린샷 → 분석 → 브라우저 자동화
  • google-mcp — 파일 검색 → 이메일 첨부
  • instantly-campaigns — 클립보드 → 이메일 템플릿

비용

무료 — 표준 라이브러리만 사용, API 호출 없음.

안전

  • 차단된 키워드: rm, sudo, shutdown, format, erase, passwd, kill
  • 앱 이름은 /Applications/에서 검증
  • AppleScript 문자열은 이스케이프 처리
  • 모든 명령에 10초 타임아웃
  • shell=True 사용 안 함

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

aiagentwithdhruv/skills

Add new Modal webhooks for event-driven execution. Use when user asks to create a webhook, add an endpoint, or set up event triggers.

aiagentwithdhruv/skills

Answer Euron Gen AI Bootcamp doubts instantly. Covers Euri API setup across all frameworks (Python, LangChain, OpenAI SDK, TypeScript, n8n, curl), MCP server setup, common errors, model recommendations, and token limits. Use when someone in the bootcamp asks a question.

aiagentwithdhruv/skills

Manage emails across multiple Gmail accounts with unified tooling. Use when user asks to check email, read inbox, label emails, archive messages, or manage Gmail across accounts.

aiagentwithdhruv/skills

Auto-label Gmail emails into Action Required, Waiting On, and Reference categories. Use when user asks to label emails, triage inbox, categorize emails, or organize Gmail.

aiagentwithdhruv/skills

Scrape Google Maps for B2B leads with deep website enrichment and contact extraction. Use when user asks to find local businesses, scrape Google Maps, generate contractor lists, or build local service business databases.

aiagentwithdhruv/skills

Run Claude orchestrator locally with Cloudflare tunneling. Use when user asks to run locally, start local server, or test webhooks locally.

aiagentwithdhruv/skills

Deploy execution scripts to Modal cloud. Use when user asks to deploy to Modal, push code to cloud, or update Modal functions.

aiagentwithdhruv/skills

Scrape and verify business leads using Apify, classify with LLM, enrich emails, and save to Google Sheets. Use when user asks to find leads, scrape businesses, generate prospect lists, or build lead databases for any industry or location.

aiagentwithdhruv/skills

Query Skool community content using RAG pipeline with vector search. Use when user asks to search Skool knowledge, find community answers, or query Skool content.

aiagentwithdhruv/skills

Scrape Upwork jobs and generate personalized proposals with cover letters. Use when user asks to find Upwork jobs, create Upwork proposals, or apply to Upwork listings.

관련 스킬