본문 바로가기
AI 오픈소스

[AI 오픈소스] AppleScript MCP: macOS 자동화를 위한 강력한 Model Context Protocol 서버

by 앨런튜링1 2025. 3. 20.
반응형

안녕하세요.

오늘은 macOS 자동화를 위한 강력한 도구인 AppleScript MCP에 대해 소개해드리겠습니다. 이 MCP 서버는 AI 기반 애플리케이션이 macOS와 원활하게 상호작용할 수 있도록 지원하며, 다양한 시스템 기능을 자동화하는 데 활용됩니다.


AppleScript MCP란?

AppleScript MCP(Model Context Protocol)는 macOS에서 AppleScript를 활용하여 LLM(대형 언어 모델, Large Language Model) 및 자동화 애플리케이션이 시스템 기능을 제어할 수 있도록 지원하는 서버입니다. 이를 통해 사용자는 다양한 macOS 기능을 자동화하고 효율적으로 관리할 수 있습니다.

AppleScript MCP의 주요 기능

🗓️ 캘린더 이벤트 및 미리 알림 관리

AppleScript MCP를 사용하면 캘린더 이벤트를 생성하고 조회할 수 있습니다. 예를 들어, 특정 날짜에 미팅을 추가하거나 당일 일정을 확인하는 것이 가능합니다.

📋 클립보드 작업 및 데이터 전송

시스템 클립보드와 상호작용하여 데이터를 복사하거나 가져올 수 있습니다. 또한 클립보드 내용을 지우는 기능도 제공합니다.

🔍 Finder 통합을 통한 파일 관리

Finder에서 선택된 파일을 가져오거나 특정 조건에 맞는 파일을 검색할 수 있습니다. 또한, 빠르게 미리 보기를 실행할 수도 있습니다.

🔔 시스템 알림 및 경고

macOS의 기본 알림 시스템을 활용하여 중요한 메시지를 사용자에게 전달할 수 있습니다. 또한, ‘방해 금지 모드’를 제어할 수도 있습니다.

⚙️ 시스템 제어(볼륨, 다크 모드, 앱 관리)

시스템 볼륨을 조정하거나 다크 모드를 활성화하는 등 macOS의 주요 기능을 직접 조작할 수 있습니다. 또한, 앱을 실행하거나 종료하는 것도 가능합니다.

📟 iTerm 터미널과의 연동

iTerm을 사용하여 명령어를 실행하거나 클립보드 내용을 터미널에 붙여넣을 수 있습니다.

반응형

AppleScript MCP의 시스템 요구 사항

AppleScript MCP를 사용하려면 다음과 같은 환경이 필요합니다:

  • macOS 10.15 Catalina 이상
  • Node.js 18 이상

AppleScript MCP 설치 및 사용법

🛠️ 설치 방법

AppleScript MCP를 설치하려면 터미널에서 다음 명령어를 실행하세요:

npm install

이후, 빌드 과정을 거친 후 서버를 실행하면 됩니다.

🚀 실행 및 테스트

서버를 실행하려면 다음 명령을 입력하세요:

npm run build

또한, MCP Inspector를 활용하여 서버의 동작을 테스트할 수 있습니다.

⚡ 기본 자동화 스크립트 실행

AppleScript MCP를 통해 기본적인 시스템 자동화를 수행할 수 있습니다. 예를 들어, 현재 실행 중인 앱을 가져오는 명령은 다음과 같습니다:

{
    "command": "get_frontmost_app"
}

세부 명령어 카테고리

🗓️ 캘린더

  • add: 새로운 일정 추가
  • list: 오늘의 일정 조회

📋 클립보드

  • set_clipboard: 내용 복사
  • get_clipboard: 클립보드 내용 가져오기
  • clear_clipboard: 클립보드 비우기

🔍 Finder

  • get_selected_files: 선택된 파일 가져오기
  • search_files: 특정 파일 검색

🔔 시스템 알림

  • send_notification: 알림 메시지 전송
  • toggle_do_not_disturb: 방해 금지 모드 전환

⚙️ 시스템 제어

  • volume: 시스템 볼륨 조정
  • toggle_dark_mode: 다크 모드 전환
  • launch_app: 특정 앱 실행
  • quit_app: 특정 앱 종료

📟 iTerm

  • paste_clipboard: 클립보드 내용을 iTerm에 붙여넣기
  • run: 터미널 명령 실행

AppleScript MCP 기능 확장 방법

📂 새로운 스크립트 카테고리 생성

새로운 기능을 추가하려면 src/categories/newcategory.ts 파일을 생성하고 스크립트를 등록하면 됩니다.

📝 사용자 지정 AppleScript 명령 작성

스크립트 내부에 AppleScript 코드를 삽입하여 새로운 자동화 기능을 개발할 수 있습니다.

📌 시스템에 새 스크립트 등록

생성한 스크립트를 src/index.ts에 추가하여 MCP 서버에 반영합니다.

향후 예정된 기능

📬 이메일 관리

이메일 목록 조회, 첨부 파일 저장, 자동 요약 및 전송 기능 추가 예정

🧭 Safari 브라우저 연동

현재 열린 페이지 내용 저장, 선택한 탭 정보 가져오기

💬 메시지 자동화

메시지 전송 및 기록 확인 기능 추가 예정

✅ 미리 알림 및 노트 관리

미리 알림 생성 및 목록 확인, 노트 생성 기능 강화

결론

AppleScript MCP는 macOS 자동화를 위한 강력한 도구로, AI 및 시스템과의 연동을 쉽게 할 수 있도록 지원합니다. 향후 기능이 확장되면 더욱 강력한 자동화 환경을 구축할 수 있을 것입니다.


출처

https://github.com/joshrutkowski/applescript-mcp

 

GitHub - joshrutkowski/applescript-mcp: A macOS AppleScript MCP server

A macOS AppleScript MCP server. Contribute to joshrutkowski/applescript-mcp development by creating an account on GitHub.

github.com

 

반응형