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

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 服务器前,你需要完成一些准备工作,确保安装以下内容:

✨ 主要特性

Apple Shortcuts MCP 服务器具备以下功能:

  • 允许 AI 助手列出可用的快捷方式。
  • 支持通过名称运行快捷方式,并可选地传递输入参数。
  • 提供一个简单的接口进行自动化控制。

📦 安装指南

配置 Claude Desktop

以下是使用苹果快捷方式服务器的 Claude Desktop 配置示例:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["-y", "mcp-server-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. 补齐环境变量后重启客户端