AppleScript MCPサーバー

「AppleScript」MCPサーバーは何をするのか？

AppleScript MCPサーバーは、AIアシスタントや開発ツールがMac上でAppleScriptコードを実行できるように設計されたModel Context Protocol（MCP）サーバーです。橋渡し役として、AIエージェントがNotes、カレンダー、連絡先、メッセージなどのMacアプリやシステム機能へアクセスし制御できるようにします。Spotlightによるファイル検索、ファイルの読み書き、シェルコマンドの実行、SSHを介したリモート実行などもサポートしています。軽量かつ直感的な設計で統合も簡単。Macユーザーの自動化・生産性・開発ワークフローを大幅に向上させ、macOSのさまざまな機能へのプログラムによるアクセスを可能にします。

プロンプトリスト

リポジトリには再利用可能なプロンプトテンプレートは記載されていません。ユーザー向けの例のみ提供されています。

リソース一覧

利用可能なドキュメントやコードには明示的なMCPリソースは記載されていません。

ツール一覧

server.jsやドキュメントには詳細なツールリストはありません。任意のAppleScriptを実行できますが、個別のツールプリミティブは列挙されていません。

このMCPサーバーの利用例

• Macアプリ自動化: Notes、カレンダー、連絡先、メッセージなどのmacOSアプリにAppleScriptコマンドを実行して、開発者やAIエージェントがワークフローを自動化できます。
• ファイル・システム管理: SpotlightやFinderでのファイル検索、ファイル内容の読み書き、フォルダやドキュメントのプログラム管理が可能です。
• システム情報取得: バッテリー残量、ディスク空き容量、実行中アプリなど、ユーザーや自動エージェントに有用なシステム状況の取得が容易です。
• リモート実行: SSH経由でAppleScriptをリモート実行でき、他のマシンやコンテナからMacを管理できます。
• メディア・コミュニケーション制御: Apple Music等のメディア再生制御や、メール・メッセージ・リマインダーなどコミュニケーションアプリの自動化も行えます。

セットアップ方法

Windsurf

1. Node.jsがシステムにインストールされていることを確認します。
2. Windsurfの設定ファイルを開きます。
3. 下記のJSONをmcpServersセクションに追加します。
4. 設定を保存し、Windsurfを再起動します。
5. サーバーが稼働しアクセス可能か確認します。

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Node.jsがインストールされていることを確認します。
2. Claudeの設定ファイルを探して開きます。
3. 下記の例のようにMCPサーバーを追加します。
4. 設定を保存し、Claudeを再起動します。
5. MCPサーバーが利用可能になっているか確認します。

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. Node.jsをシステムにインストールします。
2. Cursorの設定ファイルを開きます。
3. mcpServersセクションにAppleScript MCPサーバーのエントリを挿入します。
4. 保存してCursorを再起動します。
5. 統合が成功しているか確認します。

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Node.jsがインストールされていることを確認します。
2. Clineの設定ファイルを編集します。
3. 下記例のようにMCPサーバー構成を追加します。
4. 変更を保存しClineを再起動します。
5. MCPサーバーが動作しているかテストします。

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

APIキーや認証情報の安全な管理

リモート実行時、SSHユーザー名やパスワードなどの機密情報は環境変数経由で設定すると安全です。例：

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "yourusername",
        "REMOTE_PASSWORD": "yourpassword"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

フロー内でのMCPの使い方

FlowHuntでのMCP利用

FlowHuntワークフローにMCPサーバーを組み込むには、まずMCPコンポーネントをフローに追加し、AIエージェントと接続します。

MCPコンポーネントをクリックし、設定パネルを開きます。システムMCP設定セクションで、下記JSON形式でMCPサーバー情報を入力してください。

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

この設定により、AIエージェントが本MCPをツールとして利用でき、すべての機能にアクセス可能になります。“applescript_execute"は実際のMCPサーバー名に、URLはご自身のMCPサーバーURLに変更してください。

概要

上記の表より、AppleScript MCPサーバーはシンプルだが限定的な統合を提供します。MacをAppleScriptで直接制御できる点が強みですが、プロンプトテンプレートや明示的なMCPリソース、詳細なツールプリミティブの記載はありません。ライセンスの明示、中程度の人気、明快なセットアップ手順はプラス要素です。全体として、ニッチ用途には非常に有用ですが、ドキュメントの充実度には改善の余地があります。

MCPスコア