mcp-server-apple-shortcuts

以下是根据提供的 README 内容生成的详细介绍：

Apple Shortcuts MCP 服务器

这是一个基于模型上下文协议 (MCP) 构建的服务器，其主要功能是允许像 Claude 这样的 AI 助手控制和管理 macOS 上的 Apple Shortcuts 自动化任务。通过部署和配置此服务器，AI 模型能够以一种安全且受控的方式在用户的 macOS 系统上触发快捷指令并执行各种自动化操作。

模型上下文协议 (MCP) 解释

模型上下文协议 (MCP) 是一种专门设计的系统，旨在为 AI 应用程序（例如 Claude Desktop）提供一种标准化的方式，使其能够安全可靠地连接并与外部工具、服务或数据源进行交互。它创建了一个清晰的接口，允许 AI 助手在用户明确的控制下，与本地运行的服务和 API 协同工作，从而扩展了 AI 的能力，使其不仅仅局限于文本生成，还能执行实际的本地操作。

服务器核心功能

Apple Shortcuts MCP 服务器提供了以下核心功能：

列出快捷指令： 允许 AI 助手查询并获取用户在 macOS 上已经创建或安装的所有可用快捷指令的列表。
运行快捷指令： 支持 AI 助手根据快捷指令的名称来调用和运行它们，并且可以传递可选的输入参数，以满足特定快捷指令的需求。
提供控制接口： 提供了一个简单易用的接口，充当 AI 助手和 macOS Shortcuts 应用之间的桥梁，实现对自动化任务的控制。

使用前提条件

在设置和使用 Apple Shortcuts MCP 服务器之前，请确保您的系统满足以下条件：

已安装 Node.js (版本 18 或更高)。
已安装 Claude Desktop 应用程序。
使用 macOS 系统，并且已经配置和使用了 Apple Shortcuts 应用。

配置使用 Apple Shortcuts 服务器

要在 Claude Desktop 中使用 Apple Shortcuts MCP 服务器，您需要修改 Claude Desktop 的配置文件（通常是 config.json）。根据您是使用已发布的 npm 包还是本地构建的版本，配置方式有所不同。

使用已发布的 npm 包配置：
将以下 JSON 片段添加到您的 Claude Desktop 配置文件中 mcpServers 部分：
json { "mcpServers": { "apple-shortcuts": { "command": "npx", "args": [ "-y", "mcp-server-apple-shortcuts" ] } } }
此配置指示 Claude Desktop 使用 npx 命令来查找并执行已发布的 mcp-server-apple-shortcuts 包。
本地构建并运行服务器：
如果您希望从源代码构建并运行服务器（例如为了开发或使用最新功能），请按照以下步骤操作：
1. 克隆项目仓库：git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git
2. 进入项目目录并安装依赖：npm install
3. 构建项目：npm run build
构建完成后，修改您的 Claude Desktop 配置文件，使其指向本地构建的服务器文件：
json { "mcpServers": { "apple-shortcuts": { "command": "node", // 或根据需要使用其他命令，此处示例为直接运行 Node "args": [ "/path/to/mcp-server-apple-shortcuts/build/index.js" // 请替换为实际的构建文件路径 ] } } }
请注意，您需要将 /path/to/mcp-server-apple-shortcuts/build/index.js 替换为您本地文件系统中该文件的实际绝对路径。