mcp-ppt

🚀 PPT 制作器 MCP 服务器

本 MCP 服务器可助力用户动态创建、编辑并保存 PowerPoint 演示文稿。它基于 MCP 构建，同时运用 python-pptx 库，为用户提供了一个灵活的接口，方便添加幻灯片、图片、表格等各类元素。用户只需与大型语言模型进行简单的聊天交互，就能轻松完成演示文稿的制作、编辑与保存操作。

🚀 快速开始

安装步骤

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 启动服务器：

   python server.py
   

使用说明

配置文件修改

在 config.json 文件中添加以下配置：

{
  "server": {
    "host": "localhost",
    "port": 5000
  },
  "log": {
    "level": "info"
  }
}

示例用法

在终端中运行以下命令以生成演示文稿：

python script.py --title "我的演示文稿" --author "张三"

✨ 主要特性

• 动态创建：支持从头开始构建新的 PowerPoint 演示文稿。
• 编辑功能：允许添加、修改和删除幻灯片内容。
• 保存与导出：能够将演示文稿保存到本地文件或以其他格式导出。

📚 详细文档

API 文档

创建新演示文稿

• 接口: POST /api/presentations
• 参数:
  • title: 演示文稿标题
  • author: 作者信息
• 返回: 新生成的演示文稿 ID

添加幻灯片

• 接口: POST /api/slides/{prs_id}
• 请求体:

  {
    "slide_number": int,
    "content": str
  }
  

错误处理与调试

常见错误

• 400 Bad Request: 请求参数无效或缺失。
• 500 Internal Server Error: 服务器内部错误。

日志查看

• 检查 logs 目录中的日志文件，获取详细的错误信息和调试数据。

🤝 贡献指南

欢迎贡献！如果遇到问题或有任何改进建议，请打开问题或提交拉取请求。