keynote-mcp 是一个 Model Context Protocol（MCP）服务器，使 AI 助手能够通过 AppleScript 自动化控制 Keynote 演示文稿。它支持用自然语言创建、编辑和导出演示文稿。
主要能力
- 通过 AppleScript 自动化对 Apple Keynote 进行完整控制。
- 创建、编辑和导出演示文稿。
- 提供 30 多个可用工具。
- 可选集成 Unsplash 图片。
- 附带 keynote-presentation 技能（Claude Skill），编码了布局规则、字体规避方法和设计模式，使演示文稿首次即可正确生成。
使用方式 前提：已安装 Keynote 应用。 安装方式：
- 方式 A：从 PyPI 安装，或使用 uvx 直接运行（无需安装）。
- 方式 B：从源码安装。 注册 MCP 服务器：
- Claude Code（PyPI 安装 / uvx）
- Claude Code（从源码）
- Claude Desktop：添加到 claude_desktop_config.json，或使用 uvx。
- 其他 MCP 客户端：命令为 keynote-mcp（若通过 pip 安装）或 uvx keynote-mcp；传输方式为 stdio。 安装技能（推荐）：
- keynote-presentation 技能教会 Claude 如何正确使用 MCP 工具，处理字体裁剪 bug、主题陷阱、坐标计算和设计模式。
- Claude Code：将技能文件夹复制到技能目录。
- 将 skills/keynote-presentation 文件夹打包为 zip，进入 Settings > Capabilities > Skills，点击“Upload skill”并选择该 zip。 macOS 权限：
- 系统设置 > 隐私与安全性 > 辅助功能——添加 Terminal/你的 IDE。
- 系统设置 > 隐私与安全性 > 自动化——允许 Python 控制 Keynote。
- 安全说明：辅助功能权限按二进制文件授予，而非按项目。当授予 python 辅助功能权限后，所有 Python 进程共享该权限。大多数 keynote-mcp 工具使用普通 AppleScript（无需辅助功能权限）——只有构建动画需要该权限。如需更严格的隔离，可构建独立二进制文件，使 keynote-mcp 拥有自己的权限条目。
关于技能 keynote-presentation 技能（skills/keynote-presentation/）解决了生产使用中发现的真实问题：
- 字体裁剪 bug：大字号（>48pt）会创建极小的文本框，将文本裁剪为 1-2 个字符。技能教会 Claude 先调整大小再编辑的规避方法。
- 主题陷阱：许多主题（Gradient、Minimalist Dark）在空白幻灯片上不显示背景。技能包含经过测试的兼容性表。
- 坐标计算：不存在 text-align 属性。技能提供逐字符宽度估算，用于手动居中。
- 形状填充限制：形状填充颜色无法通过 AppleScript 写入。技能记录了深色主题容器的透明度规避方法。
- 深色主题颜色参考：经过测试的白色文本、灰色副标题、绿色代码注释和蓝色章节标题的 RGB 值。
- 双栏布局：使用 add_shape 容器实现代码在左/项目符号在右的幻灯片的经过验证的坐标。
- 设计模式：着陆页风格的幻灯片模板（hero、statement、bullets、code demo、closing），带有经过测试的位置。
项目结构 包含技能结构、项目结构、独立二进制文件等部分。
独立二进制文件 对于不想向共享 python 二进制文件授予辅助功能权限的安全意识用户，可以将 keynote-mcp 构建为具有自己权限条目的独立可执行文件。然后在 MCP 配置中使用该二进制文件。授予辅助功能权限时，它将显示为“keynote-mcp”而非“Python”。详情参见 CONTRIBUTING.md。
许可证 MIT——参见 LICENSE。
致谢
- Model Context Protocol——面向 AI 的标准化工具协议
- Unsplash——免费高质量图片
- AppleScript——macOS 自动化
- 原始项目由 easychen 创建