🚀 Keynote-MCP
Keynote-MCP 是一个模型上下文协议（MCP）服务器，它允许 AI 助手通过 AppleScript 自动化来控制 Keynote 演示文稿。
🎉 这是一个增强版分支，具有模块化架构、主题感知内容管理和全面的文档改进。
🚀 快速开始
快速设置
-
克隆仓库
git clone https://github.com/betancur/keynote-mcp.git cd keynote-mcp -
安装依赖
pip install -r requirements.txt -
授予 macOS 权限
- 打开“系统偏好设置”>“安全性与隐私”>“隐私”。
- 将“终端”和“Python”添加到“辅助功能”权限中。
- 将“Python”添加到 Keynote 的“自动化”权限中。
-
配置 Claude Desktop 编辑
~/Library/Application Support/Claude/claude_desktop_config.json文件：{ "mcpServers": { "keynote": { "command": "python3", "args": ["/path/to/keynote-mcp/mcp_server.py"] } } } -
测试服务器
python3 test_server.py
注意：请确保已安装 Keynote，并且你拥有自动化所需的适当权限。
✨ 主要特性
- 演示文稿管理：创建、打开、保存和关闭演示文稿。
- 幻灯片操作：添加、删除、复制和移动幻灯片。
- 主题感知内容：利用 Keynote 的设计元素进行专业的内容布局。
- 模块化架构：通过专门的 AppleScript 模块维护可维护的代码库。
- 导出功能：截取幻灯片截图、导出为 PDF。
📦 安装指南
安装步骤已在“快速开始”部分详细说明。
💻 使用示例
基础用法
主题感知内容（推荐）
# 创建新的演示文稿
result = await call_tool("create_presentation", {
"name": "My Presentation"
})
# 添加带有主题感知内容的幻灯片
result = await call_tool("add_slide", {
"title": "Welcome",
"layout": "Title & Content"
})
# 使用主题元素设置内容（自动定位和样式）
result = await call_tool("set_slide_content", {
"title": "Project Overview",
"subtitle": "Q4 2024 Results",
"bullet_points": ["Revenue up 15%", "New markets entered", "Team expansion"]
})
# 检查可用的主题元素
result = await call_tool("get_slide_default_elements", {"slide_number": 1})
高级用法
手动内容布局
# 在特定位置添加文本
result = await call_tool("add_text_box", {
"text": "Custom positioned text",
"x": 100,
"y": 200
})
# 精确放置图像
result = await call_tool("add_image", {
"image_path": "/path/to/image.jpg",
"x": 300,
"y": 150
})
📚 详细文档
完整的文档可在 目录中找到：
- 📖 文档索引 - 完整的文档概述。
- 🏗️ 模块化架构 - AppleScript 模块化结构。
- 🎨 主题感知内容 - 主题元素的最佳实践。
- 🗺️ 项目路线图 - 未来的开发计划和功能。
快速链接
- 入门指南：请遵循上述“快速开始”部分的说明。
- 开发者指南：模块化架构。
- 最佳实践：主题感知内容。
🚀 此分支的新特性
这个增强版本相对于原始版本有了显著的改进：
✨ 主要改进
- 🏗️ 模块化架构：将单一的 AppleScript 拆分为 5 个专门的模块，以提高可维护性。
- 🎨 主题感知内容：利用 Keynote 的内置设计元素进行智能内容布局。
- 📚 全面的文档：
docs/文件夹中提供了完整的指南。 - 🔧 增强的集成：改进了 Python - AppleScript 的模块化执行。
- 🌍 国际化：所有中文注释已翻译成英文。
🎯 主要优势
- 专业效果：主题感知功能可创建具有一致样式的演示文稿。
- 更好的性能：模块化加载仅加载必要的 AppleScript 代码。
- 易于维护：不同功能区域有专门的文件。
- 开发者友好：提供完整的文档和架构指南。
致谢：此分支基于 @easychen 的原始 keynote-mcp 项目。我们通过现代架构和专业的内容管理功能对其进行了增强。
📄 许可证
本项目采用 MIT 许可证。