AppleScript MCP Server (Dual access: python and node.js)

AppleScript MCP サーバー（Python と Node.js のデュアルアクセス）

概要

Mac とやり取りするために AppleScript コードを実行できる、Model Context Protocol（MCP）サーバーです。この MCP は、シンプルで、わかりやすく、直感的で、セットアップを最小限に抑えられるよう意図的に設計されています。

これほどシンプルで強力だとは信じられません。コアコードは100行未満です。

https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388

機能

• AppleScript を実行して Mac のアプリケーションやデータにアクセス
• メモ、カレンダー、連絡先、メッセージなどとやり取り
• Spotlight または Finder を使ってファイルを検索
• ファイルの内容の読み書きやシェルコマンドの実行
• SSH によるリモート実行をサポート

プロンプトの例

Create a reminder for me to call John tomorrow at 10am

Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"

Create a new note titled "Meeting Minutes" with today's date

Show me all files in my Downloads folder from the past week

What's my current battery percentage?

Show me the most recent unread emails in my inbox

List all the currently running applications on my Mac

Play my "Focus" playlist in Apple Music

Take a screenshot of my entire screen and save it to my Desktop

Find John Smith in my contacts and show me his phone number

Create a folder on my Desktop named "Project Files"

Open Safari and navigate to apple.com

Tell me how much free space I have on my main drive

List all my upcoming calendar events for this week

Claude Desktop での使用方法

Node.js

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

Python（uvx）

クローンは不要です。git リポジトリから直接実行できます。

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peakmojo/applescript-mcp",
        "mcp-server-applescript"
      ]
    }
  }
}

Python（ローカル開発）

ローカルで開発する場合は、リポジトリをクローンし、uv を使ってソースから実行します。

brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "mcp-server-applescript"
      ]
    }
  }
}

開発

セットアップ

brew install uv
uv sync --dev

すべてのチェックを並列実行

uv run check

これにより、リンティング、フォーマット、型チェック、テストが、カバレッジ100％で並列実行されます。

個別のコマンド

uv run lint        # ruff linter
uv run format      # ruff auto-format
uv run typecheck   # pyrefly type checker
uv run test        # pytest with 100% coverage enforcement

Docker の使用方法

Docker コンテナ内で実行する場合は、特別なホスト名 host.docker.internal を使って Mac ホストに接続できます。

設定

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

これにより、Docker コンテナから Mac ホストシステム上で AppleScript を実行できます。以下を確認してください。

1. Mac で SSH が有効になっていること（システム設定 → 共有 → リモートログイン）
2. ユーザーに適切な権限があること
3. 設定に正しい認証情報が指定されていること