keynote主讲-mcp
项目介绍
Keynote-MCP
https://github.com/user-attachments/assets/fb293e54-0795-434f-a811-7f850d36619f
⚠️ 开发通知: 本项目使用Cursor AI开发，未经人工代码审查。仅供教育和实验用途。请谨慎在生产环境中使用，并在部署前进行彻底测试。
一个模型上下文协议（MCP）服务器，使AI助手能够通过AppleScript自动化控制Keynote演示文稿。
✨ 特性
- 🎨 完整的演示文稿管理 - 创建、打开、保存和关闭演示文稿
- 📊 丰富的幻灯片操作 - 添加、删除、复制和移动幻灯片
- 📝 强大的内容管理 - 添加文本、图片、形状、表格和图表
- 📸 灵活的导出选项 - 截取幻灯片截图，导出为PDF和图片
- 🖼️ Unsplash集成 - 自动搜索并添加高质量图片
- 🔒 安全可靠 - 全面的错误处理和权限管理
- 🧪 经过充分测试 - 单元和集成测试覆盖
🚀 快速开始
预备条件
- macOS 10.14 或更高版本
- Keynote 应用程序
- Python 3.8 或更高版本
安装
-
克隆仓库
git clone https://github.com/easychen/keynote-mcp.git cd keynote-mcp -
安装依赖项
pip install -r requirements.txt -
配置环境（可选，用于Unsplash功能）
cp env.example .env # 编辑.env文件并添加您的Unsplash API密钥 -
设置macOS权限
- 前往 系统偏好设置 > 安全性与隐私 > 隐私
- 将终端和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趋势的演示文稿"
- "添加一张标题为'Machine Learning Basics'的幻灯片"
- "在第2张幻灯片上插入一张关于科技的图片"
- "将演示文稿导出为PDF"
🔧 Unsplash配置（可选）
要使用Unsplash图片功能：
- 获取API密钥: 访问 Unsplash开发者
- 配置: 将您的API密钥添加到
.env文件中：UNSPLASH_KEY=your_unsplash_access_key_here
📚 文档
🤝 贡献
我们欢迎贡献！请参阅 CONTRIBUTING.md 了解如何开始。
📄 许可证
本项目采用MIT许可证 - 详情见 LICENSE 文件。
🏆 致谢
- 模型上下文协议 - AI模型的标准工具调用协议
- Unsplash - 高质量免费图片
- AppleScript - 强大的macOS自动化
📞 联系
- 🐛 问题: GitHub Issues
- 💬 讨论: GitHub Discussions
⭐ 支持
如果这个项目对您有帮助，请给它一个 ⭐️！
赋予AI助手轻松创建和管理Keynote演示文稿的能力。