macOS自动化MCP服务

macOS Automator MCP Server 是一个基于Model Context Protocol (MCP)的服务,允许在macOS上远程执行AppleScript和JavaScript for Automation (JXA)脚本。它提供了一个预定义脚本的知识库,支持内联脚本、脚本文件和参数传递,旨在将macOS自动化集成到更大的AI驱动工作流中。

  • by steipete
  • 更新于
在 GitHub 查看 steipete/macos-automator-mcp

使用说明

基本能力

产品定位

macOS Automator MCP Server 是一个专为macOS设计的自动化脚本执行服务,通过MCP协议提供远程执行AppleScript和JXA脚本的能力,适用于需要自动化控制macOS应用和系统功能的场景。

核心功能

  • 远程执行AppleScript和JXA脚本
  • 提供丰富的预定义脚本知识库
  • 支持脚本内联、文件路径和知识库ID三种执行方式
  • 支持参数传递和输入数据处理
  • 提供脚本执行超时控制和输出格式设置

适用场景

  • 应用控制(如Safari、Mail等)
  • 文件系统操作(如创建文件夹、读写文件等)
  • 系统交互(如显示通知、设置音量等)
  • 终端自动化
  • 浏览器控制
  • 日历和提醒管理
  • 邮件自动化

工具列表

  1. execute_script: 执行AppleScript或JXA脚本,支持多种脚本来源和参数传递方式。
  2. get_scripting_tips: 检索知识库中的脚本提示和示例,帮助发现可用脚本及其使用方法。

使用教程

使用依赖

  • Node.js (版本>=18.0.0)
  • macOS系统
  • 需要配置Automation和Accessibility权限

安装教程

  1. 通过npx运行(推荐):
npx -y @steipete/macos-automator-mcp@latest
  1. 本地运行(开发或直接使用):
git clone https://github.com/steipete/macos-automator-mcp.git
cd macos-automator-mcp
npm install

调试方式

  • 设置日志级别:
LOG_LEVEL=DEBUG npx @steipete/macos-automator-mcp@latest
  • 强制重新加载知识库:
KB_PARSING=eager ./start.sh