Powerpoint Presentations

🚀 PPTX MCP 服務器

PPTX MCP 服務器是一個基於 FastMCP 的服務器，可用於以編程方式創建、編輯和渲染 PowerPoint (PPTX) 演示文稿。它支持幻燈片創建、文本和形狀插入、圖片嵌入，還能將幻燈片渲染為 PNG 圖像（藉助 LibreOffice），功能強大且實用。

🚀 快速開始

啟動服務器：

python server.py

你可以通過環境變量設置服務器的主機和端口：

• HOST（默認：127.0.0.1）
• PORT（默認：8000）

例如，要在所有接口上運行並使用 9000 端口：

HOST=0.0.0.0 PORT=9000 python server.py

或（用於開發環境中的 FastMCP）：

fastmcp dev server.py

✨ 主要特性

• 創建/清除演示文稿：啟動新的或重置現有 PPTX 文件。
• 添加幻燈片：插入具有自定義佈局的幻燈片。
• 文本與內容：在幻燈片中添加標題、內容和自定義文本框。
• 形狀：插入多種多樣的 PowerPoint 形狀（包括流程圖元素）。
• 圖片：將圖片嵌入到幻燈片中。
• 幻燈片描述：獲取幻燈片內容的文字摘要以進行驗證。
• 幻燈片渲染：將幻燈片渲染為 PNG 圖像（需要 LibreOffice）。
• 下載 PPTX：下載生成的演示文稿文件。

📦 安裝指南

安裝 Python 依賴

pip install -r requirements.txt

(或查看 pyproject.toml 獲取依賴信息)

安裝 LibreOffice（用於圖像渲染）

• Linux：sudo pacman -S libreoffice-fresh 或 sudo apt install libreoffice
• macOS：brew install --cask libreoffice
• Windows：從 libreoffice.org 下載

💻 使用示例

基礎用法

# 啟動服務器
python server.py

高級用法

# 在所有接口上運行並使用 9000 端口
HOST=0.0.0.0 PORT=9000 python server.py

# 用於開發環境中的 FastMCP
fastmcp dev server.py

📚 詳細文檔

API 概覽

服務器通過 FastMCP 提供工具和資源，包括：

• create_or_clear_presentation(filename)
• add_slide(filename, layout_index)
• add_title_and_content(filename, slide_index, title, content)
• add_textbox(filename, slide_index, text, left_inches, top_inches, width_inches, height_inches, font_size_pt, bold)
• add_shape(filename, slide_index, shape_type_name, left_inches, top_inches, width_inches, height_inches, text)
• add_picture(filename, slide_index, image, left_inches, top_inches, width_inches, height_inches)
• get_slide_content_description(filename, slide_index)
• get_slide_image(filename, slide_index) (需要 LibreOffice)
• get_pptx_file(filename)

參見代碼獲取完整參數細節和可用的形狀類型。

演示文稿與模板

• 演示文稿保存在 presentations/ 目錄中。
• 你可以在 presentations/templates/ 中添加自己的模板。

🔧 技術細節

需求

• Python 3.12+
• python-pptx
• Pillow
• FastMCP
• LibreOffice（用於幻燈片圖像渲染；需單獨安裝並確保系統 PATH 中可用）