joshrutkowski/applescript-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

395 stars 62 forks 品質 66 トレンド 20MIT

Repository Install

macOS AppleScript MCPサーバー

概要

LLMアプリケーションがAppleScriptを通じてmacOSとやり取りできるようにするモデルコンテキストプロトコルサーバーです。このサーバーは、AIアプリケーションがシステム機能の制御、ファイル管理、通知処理などを行うための標準化されたインターフェースを提供します。 - 🗓️ カレンダー管理(イベント、リマインダー) - 📋 クリップボード操作 - 🔍 Finder統合 - 🔔 システム通知 - ⚙️ システム制御(音量、ダークモード、アプリ) - 📟 iTerm端末統合 - 📬 メール(新しいメール作成、メールリスト、メール受信) - 🔄 ショートカット自動化 - 💬 メッセージ(チャットリスト、メッセージ受信、検索、メッセージ送信) - 🗒️ メモ(フォーマットされたメモ、リストノート、検索ノートの作成) - 📄 ページ(ドキュメント作成) - 🧭 Safari(Safariで開き、ページの内容を保存し、選択したページ/タブを取得)- ✅ リマインダー(作成、取得) - macOS 10.15以降 - Node.js 18以降注意:通知を送信するには、スクリプトエディター>システム設定>通知を有効にする必要があります。

概要（AI 翻訳）

AppleScriptを通じてLLMアプリケーションがmacOSとやり取りできるようにするモデルコンテキストプロトコルサーバーです。このサーバーは、AIアプリケーションがシステム機能の制御、ファイル管理、通知処理などを行うための標準化されたインターフェースを提供します。

特徴

🗓️ カレンダー管理(イベント、リマインダー)
📋 クリップボード操作
🔍 ファインダー統合
🔔 システム通知
⚙️ システム制御(音量、ダークモード、アプリ)
📟 iTerm端末統合
📬 メール(新しいメールの作成、メールのリスト、メールの受信)
🔄 ショートカット自動化
💬 メッセージ(チャットリスト、メッセージ取得、メッセージ検索、メッセージ送信)
🗒️ ノート(フォーマット済みノート、リストノート、検索ノートの作成)
📄 ページ(文書作成)

予定中の特集

🧭 Safari(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"]
    }
  }
}