Keynote Mcp

Keynote-MCP

https://github.com/user-attachments/assets/fb293e54-0795-434f-a811-7f850d36619f

⚠️ 开发说明：此项目使用 Cursor AI 开发，未经人工代码审查。项目仅供教育和实验用途。在生产环境中请谨慎使用，并在部署前进行全面测试。

一个 Model Context Protocol（MCP）服务，可通过 AppleScript 自动化让 AI 助手控制 Keynote 演示文稿。

中文文档 | English

✨ 功能

• 🎨 完整的演示文稿管理 - 创建、打开、保存和关闭演示文稿
• 📊 丰富的幻灯片操作 - 添加、删除、复制和移动幻灯片
• 📝 强大的内容管理 - 添加文本、图像、形状、表格和图表
• 📸 灵活的导出选项 - 为幻灯片截图，导出为 PDF 和图像
• 🖼️ Unsplash 集成 - 自动搜索并添加高质量图像
• 🔒 安全可靠 - 完善的错误处理和权限管理
• 🧪 测试充分 - 覆盖单元测试和集成测试

---

🚀 快速开始

前置条件

• macOS 10.14 或更高版本
• Keynote 应用
• Python 3.8 或更高版本

安装

1. 克隆仓库

   git clone https://github.com/easychen/keynote-mcp.git
   cd keynote-mcp
   

2. 安装依赖项

   pip install -r requirements.txt
   

3. 配置环境（Unsplash 功能可选）

   cp env.example .env
   # Edit .env file and add your Unsplash API key
   

4. 设置 macOS 权限

   • 前往 系统偏好设置 > 安全性与隐私 > 隐私
   • 将 Terminal 和 Python 添加到 辅助功能权限中
   • 将 Python 添加到 Keynote 的 自动化权限中

在 MCP 客户端中使用

Gemini CLI 配置

将此配置添加到 MCP 客户端：

{
  "KeynoteServer": {
    "command": "python",
    "args": ["start_server.py"],
    "env": {
      "UNSPLASH_KEY": "your_unsplash_api_key_here"
    },
    "cwd": "/path/to/keynote-mcp",
    "timeout": 5000
  }
}

Claude Desktop 配置

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "keynote": {
      "command": "python",
      "args": ["/path/to/keynote-mcp/start_server.py"],
      "env": {
        "UNSPLASH_KEY": "your_unsplash_api_key_here"
      }
    }
  }
}

其他 MCP 客户端

对于其他兼容 MCP 的客户端，请使用以下连接信息：

• 命令：python
• 参数：["start_server.py"]
• 工作目录：/path/to/keynote-mcp
• 环境变量：{"UNSPLASH_KEY": "your_api_key"}（可选）

📖 可用工具

此服务提供了全面的 Keynote 自动化工具：

🎨 演示文稿管理

• 创建、打开、保存和关闭演示文稿
• 设置主题并获取演示文稿信息
• 列出所有已打开的演示文稿

📊 幻灯片操作

• 添加、删除、复制和移动幻灯片
• 设置幻灯片布局并获取幻灯片信息
• 在幻灯片间切换

📝 内容管理

• 添加文本框、标题和副标题
• 插入文件或 Unsplash 中的图像
• 创建项目符号列表和编号列表
• 添加代码块和引文

📸 导出与截图

• 为单张幻灯片截图
• 将演示文稿导出为 PDF
• 导出为图像序列

🖼️ Unsplash 集成（可选）

• 搜索高质量图像
• 自动向幻灯片添加图像
• 支持不同的方向和样式

💡 使用示例

连接到 MCP 客户端后，你可以使用自然语言控制 Keynote：

• “创建一个关于 AI 趋势的新演示文稿”
• “添加一张标题为‘机器学习基础’的幻灯片”
• “在第 2 张幻灯片中插入一张有关技术的图像”
• “将演示文稿导出为 PDF”

🔧 Unsplash 配置（可选）

若要使用 Unsplash 图像功能：

1. 获取 API 密钥：访问 Unsplash Developers
2. 配置：将 API 密钥添加到 .env 文件：

   UNSPLASH_KEY=your_unsplash_access_key_here
   

📚 文档

• 安装指南 - 详细的设置说明
• 技术文档 - API 参考和架构
• 示例 - 使用示例和演示

🤝 参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md，了解如何开始。

📄 许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

🏆 致谢

• Model Context Protocol - 为 AI 模型提供标准化的工具调用协议
• Unsplash - 高质量免费图片
• AppleScript - 功能强大的 macOS 自动化工具

📞 联系方式

• 🐛 问题反馈：GitHub Issues
• 💬 讨论：GitHub Discussions

⭐ 支持

如果这个项目对你有帮助，请给它点个 ⭐️！

---

助力 AI 助手轻松创建和管理 Keynote 演示文稿。