MCP PPT Generator

一个基于 Model Context Protocol (MCP)的 PowerPoint 生成服务，可以根据大纲文件和模板自动生成 PPT 演示文稿。

功能特性

• 📝 大纲解析: 支持 JSON 格式的大纲文件解析
• 🎨 模板应用: 支持自定义 PPT 模板
• 🔧 MCP 协议: 完全兼容 MCP 协议，可与支持 MCP 的 AI 助手集成
• 📊 多种幻灯片类型: 支持封面页、目录页、过渡页、内容页等

安装

npm install
npm run build

使用方法

作为 MCP 服务运行

node dist/index.js

可用工具

1. generate_ppt

根据大纲文件和模板生成 PPT 文件

参数:

• outlineFile (必需): 大纲文件路径（JSON 格式）
• templateFile (可选): 模板文件路径
• outputPath (可选): 输出 PPT 文件路径
• title (可选): PPT 标题

大纲文件格式

大纲文件应为 JSON 格式，包含幻灯片数组：

[
  {
    "type": "cover",
    "title": "演示标题",
    "subtitle": "副标题"
  },
  {
    "type": "contents",
    "title": "目录",
    "items": ["第一章", "第二章", "第三章"]
  },
  {
    "type": "content",
    "title": "内容标题",
    "content": "幻灯片内容"
  }
]

支持的幻灯片类型

• cover: 封面页
• contents: 目录页
• transition: 过渡页
• content: 内容页
• end: 结束页

模板格式

模板文件为 JSON 格式，定义 PPT 的主题样式：

{
  "title": "模板名称",
  "width": 1920,
  "height": 1080,
  "theme": {
    "colors": {
      "primary": "#1f4e79",
      "secondary": "#70ad47",
      "accent": "#ffc000"
    },
    "fonts": {
      "title": "Microsoft YaHei",
      "body": "Microsoft YaHei"
    }
  }
}

测试

运行测试脚本验证功能：

node test-gen-ppt.cjs

项目结构

mcp-ppt-generator/
├── src/
│   ├── index.ts          # MCP服务主入口
│   └── ppt-generator.ts  # PPT生成核心逻辑
├── dist/                 # 编译输出目录
├── package.json
├── tsconfig.json
└── README.md

依赖项

• @modelcontextprotocol/sdk: MCP 协议 SDK
• pptxgenjs: PowerPoint 文件生成库
• fs-extra: 文件系统操作增强
• uuid: 唯一标识符生成

todo

fix: 修复模板中 svg 元素的导出问题 svg2Base64

许可证

MIT License