Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client