Keynote MCP

🚀 Keynote-MCP

Keynote-MCP 是一個模型上下文協議（MCP）服務器，它允許 AI 助手通過 AppleScript 自動化來控制 Keynote 演示文稿。

🎉 這是一個增強版分支，具有模塊化架構、主題感知內容管理和全面的文檔改進。

🚀 快速開始

快速設置

1. 克隆倉庫

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

2. 安裝依賴

   pip install -r requirements.txt
   

3. 授予 macOS 權限

   • 打開“系統偏好設置”>“安全性與隱私”>“隱私”。
   • 將“終端”和“Python”添加到“輔助功能”權限中。
   • 將“Python”添加到 Keynote 的“自動化”權限中。

4. 配置 Claude Desktop 編輯 ~/Library/Application Support/Claude/claude_desktop_config.json 文件：

   {
     "mcpServers": {
       "keynote": {
         "command": "python3",
         "args": ["/path/to/keynote-mcp/mcp_server.py"]
       }
     }
   }
   

5. 測試服務器

   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 許可證。