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

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

site icon
2025.04.22 23
PythonMac自动化日程管理文件搜索系统信息获取媒体控制开发效率日程管理娱乐功能
AppleScript MCP Server 是一个简单直观的模型上下文协议(MCP)服务器,允许用户通过运行AppleScript代码与Mac进行交互。它支持Python和Node.js两种访问方式,核心代码简洁高效,少于100行。该服务器的主要功能包括访问Mac应用程序和数据、与Notes、Calendar、Contacts、Messages等应用交互、使用Spotlight或Finder搜索文件、读写文件内容以及执行shell命令。适用于需要自动化Mac操作、管理日程、创建提醒、搜索文件等场景。
View on GitHub

Overview

基本能力

产品定位

AppleScript MCP Server 是一个用于自动化Mac操作的MCP服务器,旨在通过简单的AppleScript代码实现与Mac应用程序和数据的交互。

核心功能

  • 运行AppleScript以访问Mac应用程序和数据
  • 与Notes、Calendar、Contacts、Messages等应用交互
  • 使用Spotlight或Finder搜索文件
  • 读写文件内容和执行shell命令

适用场景

  • 创建提醒和日历事件
  • 管理笔记和联系人
  • 搜索和操作文件
  • 获取系统信息(如电池百分比、磁盘空间)
  • 控制媒体播放(如播放Apple Music中的播放列表)
  • 自动化屏幕截图和文件管理

工具列表

  • npx @peakmojo/applescript-mcp:Node.js环境下的运行工具
  • uv:Python环境下的运行工具

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  • Node.js环境:确保已安装Node.js和npm
  • Python环境:确保已安装Python和uv(通过brew install uv安装)

安装教程

Node.js

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

Python

brew install uv
git clone ...

运行服务器

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "src/applescript_mcp/server.py"
      ]
    }
  }
}

调试方式

无明确调试步骤说明。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。