Powerpoint Automation

🚀 PowerPoint 自動化 MCP 服務器用於 Claude Desktop

該項目提供了一個可與 Claude Desktop 配合使用的 PowerPoint 自動化服務器，通過 Model Control Protocol (MCP) 實現交互。藉助該服務器，Claude 能夠控制 Microsoft PowerPoint，執行創建演示文稿、添加幻燈片、修改內容等任務。

🚀 快速開始

本項目提供的 PowerPoint 自動化 MCP 服務器可與 Claude Desktop 協同工作，藉助 MCP 協議實現交互，讓 Claude 控制 PowerPoint 完成各類操作。

✨ 主要特性

• 創建、打開、保存和關閉 PowerPoint 演示文稿。
• 列出所有已打開的演示文稿。
• 獲取幻燈片信息和內容。
• 添加具有不同佈局的新幻燈片。
• 在幻燈片中添加文本框。
• 更新形狀中的文字內容。
• 設置幻燈片標題。
• 以及其他更多功能！

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴項：

   uv add fastmcp pywin32
   

3. 配置 Claude Desktop：
   • 打開 Claude Desktop。
   • 導航到設置。
   • 按照以下說明配置 MCP 服務器。

📚 詳細文檔

配置

要將 Claude Desktop 配置為使用此 MCP 服務器，請在 %APPDATA%\Claude\claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "ppts": {
      "command": "uv",
      "args": ["run", "path/to/main.py"]
    }
  }
}

如果你使用的是虛擬環境或其他 Python 可執行文件（例如 uv）：

{
  "mcpServers": {
    "ppts": {
      "command": "C:\\Path\\To\\Python\\Scripts\\uv.exe",
      "args": ["run", "C:\\Path\\To\\Project\\main.py"]
    }
  }
}

使用

配置完成後，你可以使用 Claude Desktop 來控制 PowerPoint。示例交互如下：

1. 初始化 PowerPoint：

   能否為我打開 PowerPoint？
   

2. 創建一個新的演示文稿：

   請創建一個新 PowerPoint 演示文稿。
   

3. 添加幻燈片：

   在演示文稿中添加一張新的幻燈片。
   

4. 添加內容：

   在第一頁幻燈片上添加一個文本框，內容為“你好，世界”。
   

5. 保存演示文稿：

   將演示文稿保存到 C:\Users\username\Documents\presentation.pptx
   

提供的功能

服務器提供了以下 PowerPoint 自動化功能：

• initialize_powerpoint(): 連接並顯示 PowerPoint。
• get_presentations(): 列出所有已打開的演示文稿。
• open_presentation(path): 打開一個演示文稿文件。
• get_slides(presentation_id): 獲取演示文稿中的所有幻燈片。
• get_slide_text(presentation_id, slide_id): 獲取幻燈片的文字內容。
• update_text(presentation_id, slide_id, shape_id, text): 更新形狀中的文字。
• save_presentation(presentation_id, path): 保存演示文稿。
• close_presentation(presentation_id, save): 關閉演示文稿。
• create_presentation(): 創建一個新的演示文稿。
• add_slide(presentation_id, layout_type): 添加一張新幻燈片。
• add_text_box(presentation_id, slide_id, text, left, top, width, height): 添加文本框。
• set_slide_title(presentation_id, slide_id, title): 設置幻燈片的標題。

🔧 技術細節

要求

• 安裝了 Microsoft PowerPoint 的 Windows 系統。
• Python 3.7+。
• Claude Desktop 客戶端。
• pywin32 和 fastmcp Python 包。

侷限性

• 只能在安裝了 PowerPoint 的 Windows 上運行。
• 在操作期間，PowerPoint 應用程序會打開並可見。
• 僅限於 PowerPoint COM API 所暴露的功能。

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。

📄 許可證

（此處應包含具體的許可證信息）