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

AppleScript MCP 服务（双重访问：python 和 node.js）

概述

一个可让你运行 AppleScript 代码以与 Mac 交互的模型上下文协议（MCP）服务。这个 MCP 服务特意设计得简洁、直观且易于使用，并且只需极少的配置。

它简单又强大，令人难以置信。核心代码不到 100 行。

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

功能

• 运行 AppleScript 以访问 Mac 应用和数据
• 与 Notes、Calendar、Contacts、Messages 等应用交互
• 使用 Spotlight 或 Finder 搜索文件
• 读取/写入文件内容并执行 shell 命令
• 支持通过 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

此命令会并行运行 lint、格式化、类型检查和测试，测试覆盖率为 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. 配置中提供了正确的凭据