使用说明

项目简介

PowerPoint MCP服务器 (pptx-mcp) 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供操作 PowerPoint 演示文稿的能力。通过此服务器，LLM客户端可以调用预定义的工具，实现自动化创建、修改和管理PPTX文件的功能，包括幻灯片和元素的增删改查，以及生成财务图表和应用模板等高级操作。

主要功能点

演示文稿管理：创建、保存、上传和列出工作区中的PowerPoint文件。
幻灯片操作：添加、删除、获取幻灯片数量、分析幻灯片内容、设置背景颜色。
元素操作：在幻灯片中添加、编辑和样式化文本、形状、连接线等元素，并支持根据条件查找元素。
财务图表集成：创建各种财务图表（柱状图、折线图、饼图等）和公司对比表格，目前使用虚拟数据，未来计划接入真实财务数据API。
模板管理：列出、应用和保存演示文稿模板，并支持基于模板创建幻灯片。
调试工具：提供元素映射调试功能。

安装步骤

克隆仓库:

git clone https://github.com/jenstangen1/pptx-mcp.git
cd pptx-mcp

安装依赖:

pip install -r requirements.txt

服务器配置

要将PowerPoint MCP服务器集成到MCP客户端（例如Claude），您需要配置服务器的启动命令和参数。以下是一个示例JSON配置，您需要将其添加到您的MCP客户端配置文件中：

{
    "mcpServers": {
      "powerpoint_mcp": {
        "command": "uv",
        "args": [
          "--directory",
          "您的pptx-mcp仓库目录",
          "run",
          "mcp_powerpoint_server.py"
        ]
      }
    }
}

参数说明:

'"powerpoint_mcp"': 服务器名称，您可以自定义。
'"command": "uv"': 运行服务器的命令，这里假设您使用 'uv' 运行Python脚本。（如果直接使用 'python' 运行，则将 'command' 更改为 '"python"'）
'"args"': 传递给命令的参数列表。
- '"--directory", "您的pptx-mcp仓库目录"': 指定 'uv' 命令的工作目录为您的 'pptx-mcp' 仓库的根目录。 请将 '"您的pptx-mcp仓库目录"' 替换为实际的仓库路径。
- '"run", "mcp_powerpoint_server.py"': 指示 'uv' 运行 'mcp_powerpoint_server.py' 脚本。

注意: 请确保将 '"您的pptx-mcp仓库目录"' 替换为您实际的 'pptx-mcp' 仓库在您系统中的绝对路径。MCP客户端将使用此配置来启动和连接到PowerPoint MCP服务器。

基本使用方法

启动服务器: 在仓库根目录下，运行以下命令启动PowerPoint MCP服务器：

python mcp_powerpoint_server.py

或

uv run mcp_powerpoint_server.py

服务器启动后，将监听来自MCP客户端的请求。

通过MCP客户端调用工具: 配置并连接您的MCP客户端后，您可以使用客户端提供的界面或API来调用PowerPoint MCP服务器提供的各种工具，例如：
- 使用 'list_presentations' 工具列出工作区中的演示文稿。
- 使用 'add_slide' 工具向指定演示文稿添加新的幻灯片。
- 使用 'add_text' 工具在幻灯片中添加文本框。
- 使用 'create_financial_chart' 工具创建财务图表。
- 更多工具请参考 'mcp_powerpoint_server.py' 文件中的 '@mcp.tool()' 注释部分以及 README.md 文件中 "Available MCP Tools" 章节。
具体的工具调用方法取决于您使用的MCP客户端的功能和界面。您需要参考您的MCP客户端的文档来了解如何配置和使用MCP服务器以及如何调用可用的工具。

关键词