mcp-osascript

让 Claude 控制你的 Mac。 移动窗口、点击菜单、输入文本、读取剪贴板、管理浏览器标签页、截屏、运行快捷指令——18 个带类型的工具，并提供输入验证和安全防护。

已作为 io.github.m0rvayne/mcp-osascript 收录于 官方 MCP Registry

快速开始

Claude Desktop — 一键安装。 从最新版本下载 mcp-osascript-1.1.3.mcpb，然后双击。Claude Desktop 会自行安装扩展。

或者手动将其添加到配置中：

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

将其添加到 Claude Desktop 配置中（Settings → Developer → Edit Config），重启 Claude，即可开始使用。

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

claude mcp add osascript -- npx -y mcp-osascript

git clone https://github.com/m0rvayne/mcp-osascript.git
cd mcp-osascript && npm install
# then use: "command": "node", "args": ["/path/to/mcp-osascript/server/index.js"]

试试这些提示词

安装后，可以这样询问 Claude：

工具

18 个类型化工具，每个工具都具备输入验证、错误分类和基于权限的错误消息。

自动纠正菜单

当 Claude 尝试点击不存在的菜单项时，服务会自动返回该层级中可用菜单项的列表，让 Claude 使用正确名称重试。其他 MCP 服务都做不到这一点。

User:   "Click File → Export as PDF in Preview"
Claude: calls app_menu click ["File", "Export as PDF"]
Server: "Menu item 'Export as PDF' not found in 'File'.
         Available: ['New from Clipboard', 'Open...', 'Close', 'Save',
         'Duplicate', 'Rename...', 'Export...', 'Export as PDF...']"
Claude: calls app_menu click ["File", "Export as PDF..."]
Server: "Clicked: File > Export as PDF..."

为什么选择 mcp-osascript？

星标数量衡量的是受欢迎程度，而非质量——这两个替代项目都比本项目早数月出现。上表列出的是实际使用中存在差异的方面。

安全审计

已通过四轮红队审计（由作者委托对抗性 Agent 针对源代码进行测试，并非第三方认证）。最近一轮审计针对 v1.1.2，由三个并行 Agent 分别检查 Shell 相关接口、AppleScript 转义和信息泄露。审计发现了六个实际缺陷，包括一个会悄悄使另一个工具的方案允许列表失效的工具，以及一个可能泄漏并导致服务死锁的并发槽位。所有问题均已修复，并附有回归测试。escapeAS 已通过真实的 osascript 针对 13 个字符串逃逸候选项进行验证，没有任何一个能够逃逸。

权限

工具分为三个权限级别：

• 无需权限 — 剪贴板、通知、URL、应用、文件、显示器、快捷指令。可立即使用。
• 自动化 — 浏览器标签页、最前台应用。macOS 会针对每个浏览器提示一次。
• 辅助功能 — 键盘、窗口、菜单、隐藏/取消隐藏。只需在 系统设置 → 隐私与安全性 → 辅助功能 中授权一次。
• 屏幕录制 — 仅用于截图。在 系统设置 → 隐私与安全性 → 屏幕录制 中授权。

让 Claude 运行 check_permissions，它会告诉你上述权限中哪些已获授权、每项权限会解锁哪些工具，以及剩余权限应打开哪个设置面板。权限探测为只读操作，绝不会触发权限提示。

缺少权限时，服务会明确告知你该怎么做：

"Accessibility permission required. Grant access to 'osascript'
in System Settings > Privacy & Security > Accessibility."

测试

npm test

84 项集成测试覆盖全部 18 个工具，包括输入验证、安全边界（URL 方案拦截、原型污染、脚本大小限制）、超时强制执行、权限错误处理，以及针对安全审计中每项发现的回归测试。

要求

• macOS 13+（Ventura 或更高版本）
• Node.js 18+

许可证

MIT