@8btc/ppt-generator-mcp 0.0.1

package/README.md

@@ -0,0 +1,129 @@
+# MCP PPT Generator
+
+一个基于 Model Context Protocol (MCP)的 PowerPoint 生成服务，可以根据大纲文件和模板自动生成 PPT 演示文稿。
+
+## 功能特性
+
+- 📝 **大纲解析**: 支持 JSON 格式的大纲文件解析
+- 🎨 **模板应用**: 支持自定义 PPT 模板
+- 🔧 **MCP 协议**: 完全兼容 MCP 协议，可与支持 MCP 的 AI 助手集成
+- 📊 **多种幻灯片类型**: 支持封面页、目录页、过渡页、内容页等
+
+## 安装
+
+```bash
+npm install
+npm run build
+```
+
+## 使用方法
+
+### 作为 MCP 服务运行
+
+```bash
+node dist/index.js
+```
+
+### 可用工具
+
+#### 1. generate_ppt
+
+根据大纲文件和模板生成 PPT 文件
+
+**参数:**
+
+- `outlineFile` (必需): 大纲文件路径（JSON 格式）
+- `templateFile` (可选): 模板文件路径
+- `outputPath` (可选): 输出 PPT 文件路径
+- `title` (可选): PPT 标题
+
+## 大纲文件格式
+
+大纲文件应为 JSON 格式，包含幻灯片数组：
+
+```json
+[
+  {
+    "type": "cover",
+    "title": "演示标题",
+    "subtitle": "副标题"
+  },
+  {
+    "type": "contents",
+    "title": "目录",
+    "items": ["第一章", "第二章", "第三章"]
+  },
+  {
+    "type": "content",
+    "title": "内容标题",
+    "content": "幻灯片内容"
+  }
+]
+```
+
+### 支持的幻灯片类型
+
+- `cover`: 封面页
+- `contents`: 目录页
+- `transition`: 过渡页
+- `content`: 内容页
+- `end`: 结束页
+
+## 模板格式
+
+模板文件为 JSON 格式，定义 PPT 的主题样式：
+
+```json
+{
+  "title": "模板名称",
+  "width": 1920,
+  "height": 1080,
+  "theme": {
+    "colors": {
+      "primary": "#1f4e79",
+      "secondary": "#70ad47",
+      "accent": "#ffc000"
+    },
+    "fonts": {
+      "title": "Microsoft YaHei",
+      "body": "Microsoft YaHei"
+    }
+  }
+}
+```
+
+## 测试
+
+运行测试脚本验证功能：
+
+```bash
+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

package/dist/export-pptx.d.ts

@@ -0,0 +1,6 @@
+import pptxgen from "pptxgenjs";
+import type { Slide } from "./types/slide";
+export declare const exportPPTX: (_slides: Slide[], ignoreMedia: boolean, options: {
+    viewportRatio: number;
+    viewportSize: number;
+}) => pptxgen;