Applescript MCP

🚀 AppleScriptを使用したmacOSアプリとのインタラクションガイド

このプロジェクトは、AppleScriptを通じてmacOSシステムおよびアプリケーションとどのようにインタラクションするかを示すことを目的としています。このドキュメントでは、使用方法、実装の詳細、開発プロセスなど、プロジェクトのさまざまな側面について詳しく説明しています。

✨ 主な機能

基礎機能

カレンダー操作

• カレンダーイベントの追加

tell application "Calendar"
    add event "Event Name" at date (current date)
end tell

• カレンダーイベントの検索

tell application "Calendar"
    get every event of calendar "工作"
end tell

システム環境設定

• 画面の明るさを調整

tell application "System Preferences"
    set the brightness of display to 0.8
end tell

• ネットワーク接続の管理

tell application "Network"
    connect using interface "Wi-Fi" with name "MyNetwork" and password "password123"
end tell

ファイル操作

• ファイルのコピー

tell application "Finder"
    duplicate the item "/Users/Shared/test.txt" to folder "/Users/user/Desktop"
end tell

• 新しいフォルダの作成

tell application "Finder"
    make new folder at "/Users/user/Documents" named "新建文件夹"
end tell

高度な機能

アプリケーション間のインタラクション

• Safariでリンクを開く

tell application "Safari"
    open location "https://modelcontextprotocol.io"
end tell

• Finderから他のアプリにファイルを転送

tell application "Finder" to get the selection
tell application "TextEdit" to open the result

🔧 技術詳細

技術アーキテクチャ

• スクリプトエンジン：AppleScriptに基づく言語処理。
• 実行環境：osascript コマンドを使用してターミナルでスクリプトを実行します。
• 通信プロトコル：Model Context Protocol (MCP) プロトコルに準拠。

実行フロー

1. MCPリクエストを受信する
2. リクエストパラメータを解析する
3. 対応するAppleScriptコードを生成する
4. osascript を使用してスクリプトを実行する
5. 実行結果を処理して返す

📚 ドキュメント

環境設定

# 依存関係のインストール
npm install

# サーバーの構築
npm run build

# MCPチェックツールの起動
npx @modelcontextprotocol/inspector node 指定路径/index.js 参数...

新機能の開発

新しいカテゴリファイルの作成

src/categories ディレクトリに新しいTypeScriptファイルを作成します。

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

export const 新分类: ScriptCategory = {
  name: "新分类名称",
  scripts: [
    {
      name: "脚本1",
      description: "脚本功能描述",
      execute: (params) => {
        // 脚本执行逻辑
        return result;
      }
    }
  ]
};

具体的な実装の追加

scripts 配列に具体的なスクリプト定義を追加します。各スクリプトには名前、説明、実行関数が含まれます。

🎯 高度なトピック

動的なスクリプト生成

入力パラメータに基づいて動的にAppleScriptコードを生成することができます。例えば：

generateScript(params: any): string {
    let script = '';
    if (params.action === 'openUrl') {
        script = `tell application "Safari" to open location "${params.url}"`;
    }
    return script;
}

複雑なデータ処理

スクリプトの実行前後に複雑なデータ処理を行います。例えば：

processData(data: any): any {
    // データクリーニングロジック
    const cleanedData = data.map(item => ({
        id: item.id,
        name: item.name.toUpperCase()
    }));
    
    return cleanedData;
}

💡 デバッグテクニック

MCPチェックツールの使用

modelcontextprotocol/inspector ツールを使用して、スクリプトの実行プロセスを監視およびデバッグします。

ログ設定

コードにログ出力を追加します。

import { Logger } from '../utils/logger';

// ロガーを初期化する
const logger = new Logger('script-executor');

// ログを追加する
logger.info('開始执行脚本');
try {
    // 脚本执行逻辑
} catch (error) {
    logger.error('脚本执行失败', error);
}

🔗 リソースリンク

• Model Context Protocol
• AppleScript ドキュメント
• Node.js 公式ドキュメント

🤝 コントリビューションガイド

コントリビューションの方法

1. プロジェクトリポジトリをフォークする
2. 機能ブランチを作成する
3. コードの変更をコミットする
4. プルリクエストを作成する

コード規約

• プロジェクトのコーディングスタイルに従ってください。
• 詳細なコミットメッセージを提供してください。
• 単体テストが通過することを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細は以下の通りです。

MIT License

版权 © 年份 作者姓名。

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

以上のガイドを通じて、AppleScriptを使用してmacOSアプリケーションとどのようにインタラクションするかを深く理解し、必要に応じて関連機能を開発および拡張することができます。