PPT MCP Server

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

該項目藉助模型控制協議（MCP），提供了一個可與 Claude Desktop 協同工作的 PowerPoint 自動化服務器。它能讓 Claude 與 Microsoft PowerPoint 進行交互，實現創建演示文稿、添加幻燈片、修改內容等一系列任務。

🚀 快速開始

本項目可讓 Claude Desktop 與 Microsoft 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. 添加內容：

   在幻燈片1上添加一個包含文本 "Hello World" 的文本框。
   

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。

📄 許可證

MIT License