joshrutkowski/applescript-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

395 stars 62 forks 품질 66 트렌드 20MIT

Repository Install

macOS AppleScript MCP 서버

개요

LLM 애플리케이션이 AppleScript를 통해 macOS와 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 AI 애플리케이션이 시스템 기능을 제어하고, 파일 관리하며, 알림 처리 등을 위한 표준화된 인터페이스를 제공합니다. - 🗓️ 캘린더 관리(이벤트, 알림) - 📋 클립보드 작업 - 🔍 Finder 통합 - 🔔 시스템 알림 - ⚙️ 시스템 제어(볼륨, 다크 모드, 앱) - 📟 iTerm 터미널 통합 - 📬 메일 (새 이메일 생성, 이메일 목록 작성, 이메일 수신) - 🔄 바로가기 자동화 - 💬 메시지 (채팅 목록, 메시지 받기, 메시지 검색, 메시지 전송) - 🗒️ 노트(형식화된 노트 만들기, 목록 노트, 검색 노트 작성) - 📄 페이지(문서 생성) - 🧭 Safari (사파리에서 열기, 페이지 콘텐츠 저장, 선택한 페이지/탭 가져오기) - ✅ 리마인더(생성, 가져오기) - macOS 10.15 이후 - Node.js 18 이상 참고: 알림을 보내려면 스크립트 편집기> 시스템 설정에서 알림을 활성화> 필요합니다.

개요(AI 번역)

LLM 애플리케이션이 AppleScript를 통해 macOS와 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 AI 애플리케이션이 시스템 기능을 제어하고, 파일 관리하며, 알림을 처리하는 등 표준화된 인터페이스를 제공합니다.

특징

🗓️ 캘린더 관리(이벤트, 알림)
📋 클립보드 작업
🔍 파인더 통합
🔔 시스템 알림
⚙️ 시스템 제어(볼륨, 다크 모드, 앱)
📟 iTerm 터미널 통합
📬 메일 (새 이메일 생성, 이메일 목록, 이메일 수신)
🔄 단축 자동화
💬 메시지 (채팅 목록, 메시지 수신, 메시지 검색, 메시지 전송)
🗒️ 노트 (형식화된 노트 작성, 목록 노트, 검색 노트 작성)
📄 페이지 (문서 생성)

예정된 특징

🧭 Safari (사파리에서 열기, 페이지 콘텐츠 저장, 선택한 페이지/탭 가져오기)
✅ 리마인더(만들기, 가져오기)

선수 조건

macOS 10.15 이후
Node.js 18세 이상

이용 가능한 카테고리

달력

명령어	설명	매개변수
`add`	달력 이벤트 생성	`title`, `startDate`, `endDate`, `calendar` (선택 사항)
`list`	오늘의 사건 목록	없음

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

applescript-mcp MCP Server

A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript. This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.

Features

🗓️ Calendar management (events, reminders)
📋 Clipboard operations
🔍 Finder integration
🔔 System notifications
⚙️ System controls (volume, dark mode, apps)
📟 iTerm terminal integration
📬 Mail (create new email, list emails, get email)
🔄 Shortcuts automation
💬 Messages (list chats, get messages, search messages, send a message)
🗒️ Notes (create formatted notes, list notes, search notes)
📄 Pages (create documents)

Planned Features

🧭 Safari (open in Safari, save page content, get selected page/tab)
✅ Reminders (create, get)

Prerequisites

macOS 10.15 or later
Node.js 18 or later

Available Categories

Calendar

Command	Description	Parameters
`add`	Create calendar event	`title`, `startDate`, `endDate`, `calendar` (optional)
`list`	List today’s events	None

Examples

// Create a new calendar event
Create a calendar event titled "Team Meeting" starting tomorrow at 2pm for 1 hour

// List today's events
What events do I have scheduled for today?

Clipboard

Command	Description	Parameters
`set_clipboard`	Copy to clipboard	`content`
`get_clipboard`	Get clipboard contents	None
`clear_clipboard`	Clear clipboard	None

Examples

// Copy text to clipboard
Copy "Remember to buy groceries" to my clipboard

// Get clipboard contents
What's currently in my clipboard?

// Clear clipboard
Clear my clipboard

Finder

Command	Description	Parameters
`get_selected_files`	Get selected files	None
`search_files`	Search for files	`query`, `location` (optional)
`quick_look`	Preview file	`path`

Examples

// Get selected files in Finder
What files do I currently have selected in Finder?

// Search for files
Find all PDF files in my Documents folder

// Preview a file

GitHub에서 전체 README 보기

설치

npx @modelcontextprotocol/inspector node path/to/server/index.js args...

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "applescript-mcp-server": {
      "command": "node",
      "args": ["/path/to/applescript-mcp/dist/index.js"]
    }
  }
}