Office PowerPoint

🚀 辦公室-PowerPoint 模型上下文協議（MCP）服務器

本項目是一個基於Python-pptx的模型上下文協議（MCP）服務器，可用於創建和操作PowerPoint演示文稿。它提供了一系列實用工具，能對PPT文件進行創建、編輯、保存以及信息獲取等操作。

🚀 快速開始

本服務器使用Python-pptx創建和操作PowerPoint演示文稿，提供了一系列工具來對PPT文件執行各種操作。下面為你介紹如何快速搭建並啟動該服務器。

📦 安裝指南

使用設置腳本安裝

1. 克隆此倉庫：

git clone https://github.com/your-username/ppt-mcp-server.git
cd ppt-mcp-server

2. 安裝依賴項：

pip install python-pptx requests

3. 啟動服務器：

python server.py

🔧 配置方法

服務器配置

• 服務器名稱: ppt
• 監聽地址: 0.0.0.0
• 端口號: 5000

請求格式

所有請求都需要包含以下公共參數：

✨ 主要特性

本服務器具備豐富的功能模塊，可滿足你對PPT文件的多樣化操作需求。

文檔工具

• create_presentation: 創建一個新的演示文稿。
• get_presentation_info: 獲取當前演示文稿的信息。
• set_core_properties: 設置文檔的核心屬性。

幻燈片工具

• add_slide: 向演示文稿中添加一張新的幻燈片。
• get_slide_info: 獲取特定幻燈片的信息。
• populate_placeholder: 填充幻燈片中的佔位符內容。
• add_bullet_points: 在佔位符中添加項目符號列表。

文本工具

• add_textbox: 在幻燈片上添加一個文本框。

圖像工具

• add_image: 將圖片添加到幻燈片。
• add_image_from_base64: 從Base64字符串添加圖片到幻燈片。

表格工具

• add_table: 向幻燈片中添加表格。
• format_table_cell: 格式化表格中的單元格。

形狀工具

• add_shape: 添加自選圖形到幻燈片。

圖表工具

• add_chart: 在幻燈片中添加圖表。

💻 使用示例

基礎用法

創建新的演示文稿

# 創建一個新的演示文稿
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# 添加一張標題幻燈片
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # 標題幻燈片佈局索引
        "title": "我的演示文稿",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# 填充副標題佔位符
result = use_mcp_tool(
    server_name="ppt",
    tool_name="populate_placeholder",
    arguments={
        "slide_index": slide_index,
        "placeholder_idx": 1,  # 副標題佔位符索引
        "text": "使用PowerPoint MCP服務器創建",
        "presentation_id": presentation_id
    }
)

# 保存演示文稿
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "我的演示文稿.pptx",
        "presentation_id": presentation_id
    }
)

高級用法

添加圖表

# 添加一張內容幻燈片
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide", 
    arguments={
        "layout_index": 1,  # 內容幻燈片佈局索引
        "title": "銷售數據",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# 添加柱狀圖
result = use_mcp_tool(
    server_name="ppt", 
    tool_name="add_chart", 
    arguments={
        "slide_index": slide_index,
        "chart_type": "column",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0, 
        "height": 4.5,
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "series": [
            {
                "name": "銷售額",
                "values": [10, 20, 15, 25]
            }
        ],
        "title": "季度銷售數據",
        "x_axis_title": "季度",
        "y_axis_title": "金額（萬元）",
        "presentation_id": presentation_id
    }
)

📄 許可證

本項目使用MIT許可證，具體授權內容請參閱LICENSE文件。

📞 聯繫方式

如果有任何問題或建議，請聯繫作者：

• 電子郵箱: your.email@example.com
• GitHub: 你的GitHub鏈接

⚠️ 重要提示

以上代碼示例基於實際使用場景編寫，具體實現可能因版本差異有所不同。