AppleScript-MCP

applescript-mcp MCP サーバー

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

特徴

🗓️ カレンダー管理（イベント、リマインダー）
📋 クリップボード操作
🔍 Finder との統合
🔔 システム通知
⚙️ システムコントロール（音量、ダークモード、アプリ）
📟 iTerm ターミナル統合
📬 メール（新しいメールの作成、メールの一覧表示、メールの取得）
🔄ショートカットの自動化
💬 メッセージ（チャットの一覧表示、メッセージの取得、メッセージの検索、メッセージの送信）
🗒️ メモ（フォーマットされたメモの作成、メモの一覧表示、メモの検索）
📄 Pages（ドキュメントの作成）

計画されている機能

🧭 Safari（Safariで開く、ページコンテンツを保存、選択したページ/タブを取得する）
✅ リマインダー（作成、取得）

前提条件

macOS 10.15以降
Node.js 18以降

利用可能なカテゴリ

カレンダー

指示	説明	パラメータ
`add`	カレンダーイベントを作成	`title` 、 `startDate` 、 `endDate` 、 `calendar` （オプション）
`list`	今日のイベントを一覧表示する	なし

例

// 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?

クリップボード

指示	説明	パラメータ
`set_clipboard`	クリップボードにコピー	`content`
`get_clipboard`	クリップボードの内容を取得する	なし
`clear_clipboard`	クリップボードをクリア	なし

例

// 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

ファインダ

指示	説明	パラメータ
`get_selected_files`	選択したファイルを取得する	なし
`search_files`	ファイルを検索する	`query` 、 `location` （オプション）
`quick_look`	プレビューファイル	`path`

例

// 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
Show me a preview of ~/Documents/report.pdf

通知

注意: 通知を送信するには、システム設定 > 通知 > スクリプトエディターで通知を有効にする必要があります。

指示	説明	パラメータ
`send_notification`	通知を表示	`title` 、 `message` 、 `sound` （オプション）
`toggle_do_not_disturb`	DNDモードを切り替える	なし

例

// Send a notification
Send me a notification with the title "Reminder" and message "Time to take a break"

// Toggle Do Not Disturb
Turn on Do Not Disturb mode

システム

指示	説明	パラメータ
`volume`	システム音量を設定する	`level` （0～100）
`get_frontmost_app`	アクティブアプリを入手	なし
`launch_app`	アプリケーションを開く	`name`
`quit_app`	応募を締め切る	`name` 、 `force` （オプション）
`toggle_dark_mode`	ダークモードを切り替える	なし

例

// Set system volume
Set my Mac's volume to 50%

// Get active application
What app am I currently using?

// Launch an application
Open Safari

// Quit an application
Close Spotify

// Toggle dark mode
Switch to dark mode

iTerm

指示	説明	パラメータ
`paste_clipboard`	iTermに貼り付け	なし
`run`	コマンドを実行	`command` 、 `newWindow` （オプション）

例

// Paste clipboard to iTerm
Paste my clipboard contents into iTerm

// Run a command in iTerm
Run "ls -la" in iTerm

// Run a command in a new iTerm window
Run "top" in a new iTerm window

ショートカット

指示	説明	パラメータ
`run_shortcut`	ショートカットを実行する	`name` 、 `input` （オプション）
`list_shortcuts`	利用可能なショートカットをすべて一覧表示する	`limit` （オプション）

例

// List available shortcuts
List all my available shortcuts

// List with limit
Show me my top 5 shortcuts

// Run a shortcut
Run my "Daily Note in Bear" shortcut

// Run a shortcut with input
Run my "Add to-do" shortcut with input "Buy groceries"

郵便

指示	説明	パラメータ
`create_email`	Mail.appで新しいメールを作成する	`recipient` 、 `subject` 、 `body`
`list_emails`	メールボックスからメールを一覧表示する	`mailbox` （オプション）、 `count` （オプション）、 `unreadOnly` （オプション）
`get_email`	検索で特定のメールを取得する	`subject` （オプション）、 `sender` （オプション）、 `dateReceived` （オプション）、 `mailbox` （オプション）、 `account` （オプション）、 `unreadOnly` （オプション）、 `includeBody` （オプション）

例

// Create a new email
Compose an email to john@example.com with subject "Meeting Tomorrow" and body "Hi John, Can we meet tomorrow at 2pm?"

// List emails
Show me my 10 most recent unread emails

// Get a specific email
Find the email from sarah@example.com about "Project Update"

メッセージ

指示	説明	パラメータ
`list_chats`	利用可能なiMessageとSMSチャットを一覧表示する	`includeParticipantDetails` (オプション、デフォルト: false)
`get_messages`	メッセージアプリからメッセージを受け取る	`limit` （オプション、デフォルト: 100）
`search_messages`	特定のテキストを含むメッセージを検索する	`searchText` 、 `sender` （オプション）、 `chatId` （オプション）、 `limit` （オプション、デフォルト：50）、 `daysBack` （オプション、デフォルト：30）
`compose_message`	事前に入力されたメッセージまたは自動送信でメッセージアプリを開きます	`recipient` （必須）、 `body` （オプション）、 `auto` （オプション、デフォルト：false）

例

// List available chats
Show me my recent message conversations

// Get recent messages
Show me my last 20 messages

// Search messages
Find messages containing "dinner plans" from John in the last week

// Compose a message
Send a message to 555-123-4567 saying "I'll be there in 10 minutes"

注記

指示	説明	パラメータ
`create`	マークダウンのようなフォーマットでメモを作成する	`title` 、 `content` 、 `format` （書式設定オプションはオプション）
`createRawHtml`	直接HTMLコンテンツを含むメモを作成する	`title` 、 `html`
`list`	オプションで特定のフォルダからメモを一覧表示します	`folder` （オプション）
`get`	タイトルで特定のメモを取得する	`title` 、 `folder` （オプション）
`search`	特定のテキストを含むメモを検索する	`query` 、 `folder` （オプション）、 `limit` （オプション、デフォルト：5）、 `includeBody` （オプション、デフォルト：true）

例

// Create a new note with markdown formatting
Create a note titled "Meeting Minutes" with content "# Discussion Points\n- Project timeline\n- Budget review\n- Next steps" and format headings and lists

// Create a note with HTML
Create a note titled "Formatted Report" with HTML content "<h1>Quarterly Report</h1><p>Sales increased by <strong>15%</strong></p>"

// List notes
Show me all my notes in the "Work" folder

// Get a specific note
Show me my note titled "Shopping List"

// Search notes
Find notes containing "recipe" in my "Cooking" folder

ページ

指示	説明	パラメータ
`create_document`	プレーンテキストで新しいPages文書を作成する	`content`

例

// Create a new Pages document
Create a Pages document with the content "Project Proposal\n\nThis document outlines the scope and timeline for the upcoming project."

建築

applescript-mcp サーバーは TypeScript を使用して構築されており、モジュールアーキテクチャに従います。

コアコンポーネント

AppleScriptFramework ( framework.ts ): 次の機能を果たすメインサーバークラス:
- MCPプロトコル通信を管理する
- ツールの登録と実行を処理する
- ログ機能を提供する
- AppleScriptコマンドを実行する
カテゴリ( src/categories/*.ts ): 機能別に整理されたモジュール式のスクリプトコレクション:
- 各カテゴリには関連するスクリプト（カレンダー、システム、メモなど）が含まれています。
- カテゴリはindex.tsでフレームワークに登録されます。
型( src/types/index.ts ): 以下を定義する TypeScript インターフェース:
- ScriptDefinition : 個々のスクリプトの構造
- ScriptCategory : 関連スクリプトのコレクション
- LogLevel : 標準のログレベル
- FrameworkOptions : 構成オプション

実行フロー

クライアントはMCPプロトコル経由でツール要求を送信します
サーバーは適切なカテゴリとスクリプトを識別します
スクリプトコンテンツが生成される（静的または関数を介して動的）
AppleScriptはmacOSのosascriptコマンドを介して実行されます
結果がクライアントに返されます

ログシステム

このフレームワークには、次のような包括的なログシステムが含まれています。

stderr と MCP ログプロトコルの両方にログを記録します。
複数の重大度レベル (デバッグ、情報、警告、エラーなど) をサポートします
トラブルシューティングのための詳細な実行情報を提供します

発達

設定

# Install dependencies
npm install

# Build the server
npm run build

# Launch MCP Inspector
# See: https://modelcontextprotocol.io/docs/tools/inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js args...

新しい機能の追加

1. カテゴリファイルを作成する

src/categories/newcategory.tsを作成します:

import { ScriptCategory } from "../types/index.js";

export const newCategory: ScriptCategory = {
  name: "category_name",
  description: "Category description",
  scripts: [
    // Scripts will go here
  ],
};

2. スクリプトを追加する

{
  name: "script_name",
  description: "What the script does",
  schema: {
    type: "object",
    properties: {
      paramName: {
        type: "string",
        description: "Parameter description"
      }
    },
    required: ["paramName"]
  },
  script: (args) => `
    tell application "App"
      // AppleScript code using ${args.paramName}
    end tell
  `
}

3. 登録カテゴリー

src/index.tsを更新します:

import { newCategory } from "./categories/newcategory.js";
// ...
server.addCategory(newCategory);

高度なスクリプト開発

より複雑なスクリプトの場合は、次のことが可能です。

動的スクリプト生成を使用する:
script: (args) => { // Process arguments and build script dynamically let scriptContent = `tell application "App"\n`; if (args.condition) { scriptContent += ` // Conditional logic\n`; } scriptContent += `end tell`; return scriptContent; }
複雑なデータの処理:
// Example from Notes category function generateNoteHtml(args: any): string { // Process markdown-like syntax into HTML let processedContent = content; if (format.headings) { processedContent = processedContent.replace(/^# (.+)$/gm, '<h1>$1</h1>'); // ... } return processedContent; }

デバッグ

MCPインスペクターの使用

MCP Inspector は、サーバーのテストとデバッグのための Web インターフェイスを提供します。

npm run inspector

ログ記録

環境変数を設定してデバッグログを有効にします。

DEBUG=applescript-mcp* npm start

構成例

npm run buildを実行した後、 mcp.jsonファイルに以下を追加します。

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

よくある問題

権限エラー: システム環境設定 > セキュリティとプライバシー > プライバシー > オートメーションを確認してください
スクリプトの失敗: 統合前にスクリプトエディタアプリで直接スクリプトをテストする
通信の問題: stdio ストリームがリダイレクトされていないか確認してください
データベースアクセス: 一部の機能（メッセージなど）にはフルディスクアクセス権限が必要です

リソース

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

MITライセンス - 詳細はライセンスを参照

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

LLM アプリケーションが AppleScript を通じて macOS と対話できるようにします。

Related MCP Servers

MCP-Server-Playwright
Automata-Labs-team
A
security
A
license
A
quality
Enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment
Last updated -
10
685
252
MIT License
MCP-AppleMusic
kennethreitz
A
security
A
license
A
quality
Facilitates controlling Apple Music on macOS via AppleScript through MCP commands, allowing users to manage playback, search for tracks, and create playlists.
Last updated -
10
52
MIT License
Lightning Tools MCP Server
getAlby
A
security
F
license
A
quality
Enables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.
Last updated -
3
7
1
AppleScript MCP Server
peakmojo
A
security
A
license
A
quality
A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.
Last updated -
1
128
353
MIT License

View all related MCP servers