Powerpoint Automation MCP

🚀 MCP 服務器演示 - PowerPoint 自動化

本項目展示瞭如何藉助 MCP（模型完成協議）搭建一個具備 PowerPoint 自動化功能的服務器，為用戶提供便捷的演示文稿自動化操作體驗。

🚀 快速開始

你可以通過以下鏈接查看項目演示： 演示鏈接

✨ 主要特性

• 📄 創建、打開和保存 PowerPoint 演示文稿
• 📑 添加和修改幻燈片
• 📝 添加文本框、圖片、表格和圖表
• ✍️ 更新文本內容和形狀屬性
• 📊 獲取表格內容

📦 安裝指南

要運行服務器，可使用以下命令：

uv run --directory  /path/to/mcp-ppt-server mcp-ppt-server 

💻 使用示例

基礎用法

該服務器公開了多種用於 PowerPoint 自動化的工具，可通過 MCP 調用。服務器設計為一次僅處理一個活動演示文稿，從而簡化 API，無需跟蹤和指定演示文稿 ID。

演示文稿管理

• initialize_powerpoint(): 初始化 PowerPoint 自動化
• create_presentation(): 創建一個新的演示文稿
• open_presentation(file_path): 從指定路徑打開現有演示文稿
• get_presentation(): 獲取當前活動演示文稿的信息
• save_presentation(path=None): 將活動演示文稿保存到磁盤（如果之前已保存，路徑可選）
• close_presentation(): 關閉當前活動演示文稿

幻燈片管理

• get_slides(): 獲取活動演示文稿中所有幻燈片的列表
• add_slide(layout_index=1): 添加一張新幻燈片（指定佈局，默認為標題和內容）
  • 佈局選項：0=標題幻燈片，1=標題和內容，2=章節標題，3=兩部分內容等。
• set_slide_title(slide_index, title): 設置幻燈片的標題文本

內容管理

• get_slide_text(slide_index): 獲取幻燈片中的所有文本內容
• get_slide_shapes(slide_index): 獲取幻燈片中所有形狀及其 ID 和屬性
• update_text(slide_index, shape_index, text): 更新形狀的文本內容
• update_shape_by_id(slide_index, shape_id, text=None, left=None, top=None, width=None, height=None): 通過 ID 更新形狀屬性（可選參數包括文本、左、上、寬、高）
• update_table_cell(slide_index, shape_index, row, col, text): 更新表格中的單元格文本

內容添加

• add_textbox(slide_index, text, left=1, top=1, width=4, height=2): 在幻燈片中添加文本框
• add_image(slide_index, image_path, left=1, top=1, width=None, height=None): 在幻燈片中添加圖片
• add_table(slide_index, shape_index, rows, cols, text): 在幻燈片中添加表格（參數包括行數、列數和文本內容）
• add_chart(slide_index, chart_type, data): 在幻燈片中添加圖表（參數包括圖表類型和數據）

📚 詳細文檔

錯誤處理

如果發生錯誤，服務器將返回一個包含以下鍵的字典：

• error_code: 錯誤代碼
• error_message: 錯誤消息
• traceback: 調用棧信息

示例錯誤響應：

{
  "error_code": 500,
  "error_message": "Internal Server Error",
  "traceback": "Traceback (most recent call last):
    ...
"
}

MCP 配置

以下是一個 MCP 配置的示例：

{
  "server": {
    "host": "localhost",
    "port": 8000,
    "debug": true
  },
  "database": {
    "uri": "mongodb://localhost:27017",
    "name": "mcp_ppt"
  }
}