项目简介

本项目是一个MCP服务器，旨在通过 Claude Desktop 等 MCP 客户端自动化控制 Microsoft PowerPoint。它允许用户通过自然语言指令，让 Claude 等 LLM 应用调用服务器提供的工具，从而实现对 PowerPoint 演示文稿的各种操作，例如创建、打开、编辑、保存和关闭演示文稿，以及添加、修改幻灯片和文本内容等。

主要功能点

连接和控制 PowerPoint: 初始化并连接到本地安装的 PowerPoint 应用程序，支持创建新的 PowerPoint 实例或连接到已运行的实例。
演示文稿管理:
- 获取当前打开的所有演示文稿列表。
- 打开指定路径的演示文稿。
- 创建新的演示文稿。
- 保存演示文稿到指定路径或默认位置。
- 关闭指定的演示文稿。
幻灯片操作:
- 获取演示文稿中所有幻灯片的列表。
- 获取指定幻灯片的文本内容。
- 添加新的幻灯片，并可指定幻灯片布局类型。
- 设置幻灯片的标题。
形状和文本编辑:
- 在幻灯片上添加文本框，并设置文本内容和位置尺寸。
- 更新幻灯片中指定形状的文本内容。

安装步骤

克隆仓库: 将 GitHub 仓库 'PPT_MCP_Server' 克隆到本地。

git clone https://github.com/socamalo/PPT_MCP_Server.git
cd PPT_MCP_Server

安装依赖: 使用 'uv' 包管理器安装项目所需的 Python 库 'fastmcp' 和 'pywin32'。
```
uv add fastmcp pywin32
```
确保您的 Python 环境已安装 'uv'。如果未安装，请先安装 'uv'。

服务器配置

要将此 MCP 服务器配置到 Claude Desktop 或其他 MCP 客户端，您需要提供服务器的启动命令和参数。以下是配置信息，请添加到您的 MCP 客户端配置文件中。以 Claude Desktop 为例，配置文件通常位于 '%APPDATA%\Claude\claude_desktop_config.json'。

{
  "mcpServers": {
    "ppts": {
      "command": "uv",
      "args": ["run", "main.py"]
    }
  }
}

配置参数说明:

'"ppts"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识此服务器。
'"command": "uv"': 启动服务器的命令。这里假设您使用 'uv' 包管理器运行 Python 脚本。如果使用其他方式（例如直接使用 'python'），请相应修改。
'"args": ["run", "main.py"]': 'uv run' 命令的参数，指定运行 'main.py' 文件。'main.py' 是此 MCP 服务器的入口点。

注意:

请确保您的系统已安装 Microsoft PowerPoint，并且运行此服务器的计算机可以访问 PowerPoint。

如果您使用虚拟环境或 Python 可执行文件的路径不在系统 'PATH' 环境变量中，您可能需要提供 Python 可执行文件的完整路径。例如：

{
  "mcpServers": {
    "ppts": {
      "command": "C:\\Path\\To\\Python\\Scripts\\uv.exe",
      "args": ["run", "C:\\Path\\To\\Project\\main.py"]
    }
  }
}

请将 '"C:\Path\To\Python\Scripts\uv.exe"' 和 '"C:\Path\To\Project\main.py"' 替换为您的实际路径。

基本使用方法

配置完成后，您可以在 MCP 客户端（如 Claude Desktop）中使用自然语言指令来调用 PowerPoint 自动化功能。以下是一些示例：

初始化 PowerPoint: 让服务器连接到 PowerPoint 应用。

请打开 PowerPoint。

创建新演示文稿: 创建一个新的空白演示文稿。

请创建一个新的 PowerPoint 演示文稿。

添加幻灯片: 在当前演示文稿中添加一张新幻灯片。

请添加一张新幻灯片。

添加文本内容: 在指定幻灯片上添加文本框并输入文字。

请在第一张幻灯片上添加一个文本框，内容为 "你好，世界"。

保存演示文稿: 将当前演示文稿保存到指定路径。

请将演示文稿保存到 C:\Users\username\Documents\presentation.pptx

请参考仓库 'README.md' 文件中 "Available Functions" 部分，了解更多可用的 PowerPoint 自动化功能。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息