applescript-mcp MCP サーバー

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

特徴

• 🗓️ カレンダー管理（イベント、リマインダー）

• 📋 クリップボード操作

• 🔍 Finder との統合

• 🔔 システム通知

• ⚙️ システムコントロール（音量、ダークモード、アプリ）

• 📟 iTerm ターミナル統合

• 📬 メール（新しいメールの作成、メールの一覧表示、メールの取得）

• 🔄ショートカットの自動化

• 💬 メッセージ（チャットの一覧表示、メッセージの取得、メッセージの検索、メッセージの送信）

• 🗒️ メモ（フォーマットされたメモの作成、メモの一覧表示、メモの検索）

• 📄 Pages（ドキュメントの作成）

計画されている機能

• 🧭 Safari（Safariで開く、ページコンテンツを保存、選択したページ/タブを取得する）

• ✅ リマインダー（作成、取得）

前提条件

• macOS 10.15以降

• Node.js 18以降

利用可能なカテゴリ

カレンダー

例

クリップボード

例

ファインダ

例

通知

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

例

システム

例

iTerm

例

ショートカット

例

郵便

例

メッセージ

例

注記

例

ページ

例

建築

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

コアコンポーネント

1. AppleScriptFramework ( framework.ts ): 次の機能を果たすメイン サーバー クラス:

   • MCPプロトコル通信を管理する

   • ツールの登録と実行を処理する

   • ログ機能を提供する

   • AppleScriptコマンドを実行する

2. カテゴリ( src/categories/*.ts ): 機能別に整理されたモジュール式のスクリプト コレクション:

   • 各カテゴリには関連するスクリプト（カレンダー、システム、メモなど）が含まれています。

   • カテゴリはindex.tsでフレームワークに登録されます。

3. 型( src/types/index.ts ): 以下を定義する TypeScript インターフェース:

   • ScriptDefinition : 個々のスクリプトの構造

   • ScriptCategory : 関連スクリプトのコレクション

   • LogLevel : 標準のログレベル

   • FrameworkOptions : 構成オプション

実行フロー

1. クライアントはMCPプロトコル経由でツール要求を送信します

2. サーバーは適切なカテゴリとスクリプトを識別します

3. スクリプトコンテンツが生成される（静的または関数を介して動的）

4. AppleScriptはmacOSのosascriptコマンドを介して実行されます

5. 結果がクライアントに返されます

ログシステム

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

• stderr と MCP ログプロトコルの両方にログを記録します。

• 複数の重大度レベル (デバッグ、情報、警告、エラーなど) をサポートします

• トラブルシューティングのための詳細な実行情報を提供します

発達

設定

新しい機能の追加

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

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

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

3. 登録カテゴリー

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

高度なスクリプト開発

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

1. 動的スクリプト生成を使用する:

   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; }

2. 複雑なデータの処理:

   // 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 buildを実行した後、 mcp.jsonファイルに以下を追加します。

よくある問題

• 権限エラー: システム環境設定 > セキュリティとプライバシー > プライバシー > オートメーションを確認してください

• スクリプトの失敗: 統合前にスクリプトエディタアプリで直接スクリプトをテストする

• 通信の問題: stdio ストリームがリダイレクトされていないか確認してください

• データベースアクセス: 一部の機能（メッセージなど）にはフルディスクアクセス権限が必要です

リソース

• AppleScript言語ガイド

• MCPプロトコルドキュメント

• 問題トラッカー

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

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