项目简介

本项目是一个 MCP (Model Context Protocol) 服务器，它允许 AI 助手（如 Claude）控制 macOS 上的 Apple 快捷指令。通过这个服务器，AI 可以安全地调用快捷指令来自动化 macOS 上的任务，例如快速启动应用、控制系统设置或执行复杂的 workflow。

主要功能点

列出快捷指令: AI 助手可以查询并获取当前 macOS 上安装的所有快捷指令的名称列表。
运行快捷指令: AI 助手可以通过指定快捷指令的名称来运行它，还可以传递可选的文本输入参数给快捷指令，以控制快捷指令的具体行为。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆 GitHub 仓库到本地：

git clone https://github.com/MCP-Mirror/recursechat_mcp-server-apple-shortcuts.git
cd recursechat_mcp-server-apple-shortcuts

安装依赖: 确保你的 macOS 系统上已经安装了 Node.js (v18 或更高版本)。在克隆的仓库目录下，运行以下命令安装项目依赖：
```
npm install
```
构建项目: 运行以下命令构建项目，生成可执行的服务器代码：
```
npm run build
```

服务器配置

要让支持 MCP 协议的客户端 (例如 Claude Desktop) 连接到这个服务器，你需要在客户端的 MCP 服务器设置中添加配置信息。以下是 Claude Desktop 的配置示例，用于连接到 已发布到 npm 的版本：

{
  "mcpServers": {
    "apple-shortcuts": {  // "apple-shortcuts" 是你为该服务器自定义的名称，在客户端中引用时会用到
      "command": "npx",  // "command" 指定了启动服务器的命令，这里使用 npx 来运行 npm 包
      "args": ["-y", "mcp-server-apple-shortcuts"] // "args" 是命令的参数，"-y" 表示自动安装缺少的 npm 包，"mcp-server-apple-shortcuts" 是要执行的 npm 包名称
    }
  }
}

如果你希望连接到 本地构建的版本，可以使用以下配置。请将 '/path/to/mcp-server-apple-shortcuts' 替换为你的本地仓库的绝对路径：

{
  "mcpServers": {
    "apple-shortcuts": { // "apple-shortcuts" 是服务器名称，可以自定义
      "command": "node", // "command" 指定使用 node 命令来运行 JavaScript 文件
      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"] // "args" 是命令的参数，指向本地构建的服务器入口文件 '/path/to/mcp-server-apple-shortcuts/build/index.js'
    }
  }
}

基本使用方法

完成配置后，在 MCP 客户端 (如 Claude) 中，你可以通过自然语言指令来使用 Apple Shortcuts 服务器的功能：

列出快捷指令: 你可以向 Claude 提问类似于 "列出快捷指令" 或 "有哪些快捷指令" 的问题，Claude 就会调用 'list_shortcuts' 工具，返回可用的快捷指令列表。
运行快捷指令: 你可以指示 Claude 运行特定的快捷指令，例如 "运行快捷指令 [快捷指令名称]" 或 "执行快捷指令 [快捷指令名称]"。如果快捷指令需要输入，可以尝试 "运行快捷指令 [快捷指令名称] 输入 [输入内容]"。例如，要运行名为 "My Shortcut" 的快捷指令，你可以说 "运行快捷指令 My Shortcut"。

请注意，首次使用可能需要授权允许快捷指令被外部程序调用。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息