返回 MCP 目录
public公开dns本地运行

recursechat_mcp-server-apple-shortcuts

一个让AI助手通过MCP协议控制苹果快捷指令的服务器,实现自动化任务触发

article

README

🚀 Apple Shortcuts MCP 服务器 🤖

Apple Shortcuts MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器,它能让 Claude 这类 AI 助手控制苹果快捷方式自动化。借助该服务器,AI 模型可触发快捷方式,在 macOS 上安全且受控地执行任务。

🚀 快速开始

Apple Shortcuts MCP 服务器允许 AI 助手与苹果快捷方式集成,实现自动化任务。开始使用前,需完成必要的前提条件检查和配置。

✨ 主要特性

  • 快捷方式管理:允许 AI 助手列出可用的快捷方式。
  • 快捷方式执行:支持通过名称运行快捷方式,还可选择输入参数。
  • 简单接口:提供简单的自动化控制接口。

📦 安装指南

使用前提条件 📋

在开始使用之前,请确保已安装以下软件:

配置以使用 Apple Shortcuts 服务器 ⚙️

以下是 Claude Desktop 的配置示例,用于连接到 Apple Shortcuts 服务器:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["-y", "mcp-server-apple-shortcuts"]
    }
  }
}

在本地构建并运行 Apple Shortcuts 服务器 🛠️

  1. 克隆此仓库:
git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

在 Claude Desktop 中使用本地构建的服务器,可参考以下配置:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
    }
  }
}

💻 使用示例

基础用法

你可以让 Claude 执行“列出快捷方式”或通过名称运行特定快捷方式,例如“获取每日词汇”或“播放一首歌”。

📄 许可证

本项目采用 Apache-2.0 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端