JinDaGe - mcp-server-apple-shortcuts MCP Details

article

README

🚀 Apple Shortcuts MCP 服务器 🤖

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

🚀 快速开始

在使用 Apple Shortcuts MCP 服务器前，你需要完成一些准备工作，确保安装以下内容：

Node.js（版本 18 或更高）
已安装 Claude Desktop
macOS 上已配置好 Shortcuts 应用

✨ 主要特性

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

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

📦 安装指南

配置 Claude Desktop

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

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

本地构建并运行

克隆此仓库：

git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git

安装依赖项：

npm install

构建项目：

npm run build

以下是使用本地构建的苹果快捷方式服务器的 Claude Desktop 配置示例：

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

💻 使用示例

基础用法

你可以让 Claude 执行类似“列出快捷方式”或“运行‘获取单词’”的操作，例如：“获取单词”或“播放一首歌”。

📄 许可证

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

mcp-server-apple-shortcuts