Apple Shortcuts MCP

Claude + MacOS 快捷指令

这是一个简单的 MCP 服务，利用 MacOS 快捷指令功能来执行特定任务：

1. 调用 Gemini Video Understanding API，从食谱中提取食材（这也是我最初开始构建这个项目的原因）
2. 将提取出的食材添加到“提醒事项”应用中的列表（这要求你在“提醒事项”应用中有一个“Groceries”列表）
3. 总结聊天对话，并将摘要添加到新建的备忘录中。
4. 创建日历事件

要使用上述所有功能，你需要在 Mac 上设置以下快捷指令：

1. 添加到 Groceries 列表：https://www.icloud.com/shortcuts/6f696d784722468097df8ed238f8eaf2
2. 总结并创建备忘录：https://www.icloud.com/shortcuts/bb0d13d3790c48e5b78eb26dbc7e3aca
3. 日历：https://www.icloud.com/shortcuts/c01969b7e92343dfa3f38caad3a08f40

添加上述快捷指令后，按照以下步骤设置 MCP 服务：

1. 克隆仓库
2. 安装 uv（brew install uv）
3. 进入此仓库的目录，运行 uv sync，然后运行 uv pip install google-genai
4. 复制下方指定的 Claude 配置 JSON，填入你的 Gemini API 密钥，并更新 claude_desktop_config.json 文件
5. 打开或重新打开 Claude，现在应该就能看到这些工具了。

配置：

{
  "mcpServers": {
    "Shortcuts-MCP": {
      "command": "uv",
      "args": [
        "--directory",
        "ABSOLUTE/PATH/TO/THIS/DIRECTORY",
        "run",
        "main.py"
      ],
      "env": {
        "GEMINI_API_KEY": "your_gemini_api_key"
      }
    }
  }
}

用法

1. 提取食材并创建购物清单：只需发送 YouTube 上食谱的视频 URL，并让 Claude 将食材添加到你的清单中。
2. 日历：提供有关事件的背景信息，以及开始和结束日期时间。

你可以将这些工具串联使用，例如：先让它提取食材，再单独让它创建清单并添加日历事件。

故障排除

确保已安装 Python、uv 和其他依赖项。在 Mac 上的“提醒事项”应用中创建一个“Groceries”列表，以确保快捷指令正常运行。

贡献

如果你还有其他有趣的 Mac 快捷指令可以通过 Claude/MCP 触发，欢迎在此添加你的工具。