truth0530 GitHub avatar

mcp-server-ios-shortcuts

truth0530

一个零依赖的 Python MCP 服务器,面向 macOS,通过 Apple 的 shortcuts CLI 让 AI 代理能够构建、签名、导入、列出、运行、检查和分享 iOS/macOS 快捷指令。

Stars

6

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

MIT

最近更新

2026-07-30

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它将自然语言意图转化为已签名的 .shortcut 文件,并支持多种 MCP 客户端,同时提供反编译、配方校验、魔法变量和诚实的动作覆盖机制,显著降低手工编写快捷指令的难度。

适合谁使用

  • 在 macOS 上使用 AI 编码代理(如 Grok、Codex、Claude、Cursor、Gemini)的用户
  • 需要批量或程序化创建、修改 Apple 快捷指令的高级用户
  • 构建 MCP 工具链或快捷指令自动化管道的开发者

典型使用场景

  • 让 AI 代理根据自然语言构建、签名并导入快捷指令
  • 对现有 .shortcut 反编译为可编辑 JSON,用于修改或克隆
  • 使用内置模板快速生成常用快捷指令,如截图 OCR、剪贴板通知、HTTP 请求
  • 在不离开 MCP 客户端的情况下列出、运行和检查已安装的快捷指令

项目优势

  • 仅用 Python 3.8+ 标准库实现,零依赖、无需 pip install
  • 提供从动作目录、配方校验、反编译到构建/签名/导入的完整工具链
  • 有安全沙箱、SAFE_MODE、send_imessage 不自动发送等安全设计
  • 为 Grok、Codex、Claude、Cursor、Gemini/Antigravity 等客户端提供现成配置

使用前须知

  • 仅支持 macOS Monterey 及以上,且依赖系统 shortcuts CLI,不支持跨平台
  • 通用动作路径采用自动强制转换,而非完整 Apple schema 等价,某些动作可能需要人工校验或使用原始 WF 动作
  • 部分学习功能需要完全磁盘访问权限;safe mode 会阻止 run_shortcut 和 send_imessage 等工具

README 快速开始

Quick start

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

Blaizzy
精选
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI 与机器学习AI 视觉与语音
985
makecindy
精选
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI 与机器学习大语言模型
958
uzairansaruzi
精选
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI 与机器学习大语言模型
941