项目简介
PowerPoint MCP Server 是一个基于 Model Context Protocol (MCP) 的应用后端,它扩展了 LLM 的能力,使其能够创建和编辑 PowerPoint 演示文稿。通过集成多种工具,该服务器允许 LLM 客户端通过标准化的 MCP 协议,操控 PowerPoint 的各项功能,例如创建演示文稿、添加各种类型的幻灯片(包括文字、图片、表格、图表等),并支持使用 Stable Diffusion 生成图像。
主要功能点
- 创建演示文稿: 允许LLM 创建全新的 PowerPoint 演示文稿。
- 编辑演示文稿: 支持打开已有的演示文稿进行编辑。
- 添加各种类型的幻灯片: 包括标题页、内容页、节标题页、带表格和图表的幻灯片、以及带图片的幻灯片。
- 图片生成: 集成 Stable Diffusion API,可以根据文本提示生成图像并插入到幻灯片中。
- 保存演示文稿: 将编辑完成的演示文稿保存到指定文件夹。
安装步骤
- 安装 UV: 确保你的系统已安装 UV 包管理器。如果未安装,请根据仓库提供的命令进行安装。
# MacOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - 克隆仓库: 使用 'git clone' 命令克隆 'powerpoint-mcp' 仓库到本地。
git clone https://github.com/Ichigo3766/powerpoint-mcp.git - 安装依赖: 导航到仓库目录,运行 'uv pip install .' 安装项目依赖。
服务器配置
要将 PowerPoint MCP 服务器与 MCP 客户端(例如 Claude)连接,您需要配置客户端的 MCP 服务器设置。以下是一个示例 JSON 配置,你需要根据你的实际环境进行调整。
{ "mcpServers": { "powerpoint": { "command": "uv", "args": [ "--directory", "/path/to/powerpoint-mcp/src", // 请替换为仓库src目录的绝对路径,例如 /Users/yourname/powerpoint-mcp/src "run", "powerpoint", "--folder-path", "/path/to/decks_folder" // 请替换为你希望演示文稿和图片保存的文件夹路径,例如 /Users/yourname/powerpoint_decks ], "env": { "SD_WEBUI_URL": "http://your-sd-webui-url:7860", // 请替换为你的 Stable Diffusion WebUI API 的 URL,例如 http://127.0.0.1:7860 "SD_AUTH_USER": "your-username", // (可选) 如果你的 Stable Diffusion WebUI API 需要身份验证,请填写用户名 "SD_AUTH_PASS": "your-password" // (可选) 如果你的 Stable Diffusion WebUI API 需要身份验证,请填写密码 } } } }
配置说明:
- 'command': 启动服务器的命令,这里使用 'uv' 包管理器来运行 Python 脚本。
- 'args': 传递给 'uv' 命令的参数列表,用于指定运行目录、运行的包以及服务器所需的额外参数:
- '--directory': 指定仓库 'src' 目录的绝对路径,MCP 服务器代码位于此目录下。
- 'run powerpoint': 指示 'uv' 运行 'powerpoint' 包,这将执行 'src/powerpoint/init.py' 文件中的 'main' 函数,从而启动 MCP 服务器。
- '--folder-path': 指定一个文件夹路径,用于存放生成的 PowerPoint 演示文稿和图片。请根据你的需求修改此路径。
- 'env': 环境变量配置,用于配置与 Stable Diffusion API 的连接。
- 'SD_WEBUI_URL': Stable Diffusion WebUI API 的 URL。确保 Stable Diffusion WebUI 正在运行,并将 URL 替换为你的 WebUI 地址。
- 'SD_AUTH_USER', 'SD_AUTH_PASS': 如果你的 Stable Diffusion WebUI API 启用了身份验证,请提供用户名和密码。如果不需要身份验证,则可以省略这两个字段。
重要: 请根据你的实际文件路径、Stable Diffusion WebUI API 地址以及是否需要身份验证,修改上述配置中的路径和参数。
基本使用方法
- 启动 MCP 服务器: 配置好 MCP 客户端后,启动客户端,客户端会根据配置连接到 PowerPoint MCP 服务器。
- 使用 LLM 客户端发送指令: 通过 LLM 客户端,使用自然语言指令指示其调用 PowerPoint MCP 服务器提供的工具。例如,你可以指示 LLM "创建一个关于太阳系的演示文稿" 或 "在演示文稿中添加一张关于火星的图片"。
- 查看和编辑演示文稿: LLM 客户端会调用相应的工具在服务器端创建或编辑 PowerPoint 演示文稿。你可以在配置的 'folder-path' 文件夹中找到生成的演示文稿文件,并使用 PowerPoint 软件打开查看和进一步编辑。
注意事项
- 确保已安装 PowerPoint 软件,以便在本地查看和编辑生成的演示文稿。
- 首次使用图片生成功能时,请确保 Stable Diffusion WebUI API 服务已正确配置并可访问。
- 'folder-path' 指定的文件夹需要存在并且具有写入权限,以便服务器可以保存演示文稿和图片。
信息
分类
生产力应用