🚀 办公室-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链接

⚠️ 重要提示

以上代码示例基于实际使用场景编写，具体实现可能因版本差异有所不同。