PptxGenJS MCP Server

基于 PptxGenJS 的 MCP (Model Context Protocol) 服务器，提供 PowerPoint 演示文稿创建和编辑功能。

功能特性

• 会话状态管理: 每个会话维护独立的 PPT 实例
• 创建和管理 PPT: 创建新的演示文稿（支持详细配置参数）、打开现有文件、保存文件
• 幻灯片操作: 创建、添加、删除幻灯片
• 内容添加: 支持添加图表、图片、媒体、表格、文本等内容
• 多种启动模式: 支持 STDIO 和 SSE 两种模式
• 丰富的配置选项: 支持元数据、布局、主题、RTL 模式等详细配置

安装

npm install
npm run build

使用方法

启动服务器

STDIO 模式（默认）

npm start
# 或者明确指定
npm start -- --mode=stdio

SSE 模式（Server-Sent Events）

npm start -- --mode=sse --port=3000

SSE 模式将启动一个 HTTP 服务器，提供以下端点：

• GET /sse - 建立 SSE 连接
• POST /messages - 接收 MCP 消息

服务器将根据指定的模式启动，可以与支持 MCP 的客户端进行通信。

或者开发模式：

npm run dev

可用工具

1. create_ppt

创建新的 PowerPoint 演示文稿

支持丰富的配置参数：

元数据属性：

• title - 演示文稿标题
• author - 作者
• subject - 主题
• company - 公司
• revision - 版本号

布局选项：

• layout - 预定义布局（如 'LAYOUT_16x9', 'LAYOUT_16x10', 'LAYOUT_4x3', 'LAYOUT_WIDE'）
• customLayout - 自定义布局对象：
  • name - 布局名称
  • width - 宽度（英寸）
  • height - 高度（英寸）

其他选项：

• rtlMode - 启用从右到左文本模式（布尔值）
• theme - 主题设置对象：
  • headFontFace - 标题字体
  • bodyFontFace - 正文字体
  • lang - 语言代码

详细配置示例：

{
  "name": "create_ppt",
  "arguments": {
    "title": "我的演示文稿",
    "author": "张三",
    "subject": "产品介绍",
    "company": "ABC 公司",
    "revision": "1.0",
    "layout": "LAYOUT_16x9",
    "theme": {
      "headFontFace": "Microsoft YaHei",
      "bodyFontFace": "Microsoft YaHei",
      "lang": "zh-CN"
    }
  }
}

自定义布局示例：

{
  "name": "create_ppt",
  "arguments": {
    "title": "自定义布局演示",
    "customLayout": {
      "name": "A4_PORTRAIT",
      "width": 8.27,
      "height": 11.69
    },
    "rtlMode": true
  }
}

简单创建示例：

{
  "name": "create_ppt",
  "arguments": {}
}

2. open_ppt

打开现有的 PowerPoint 文件

{
  "name": "open_ppt",
  "arguments": {
    "filePath": "path/to/presentation.pptx"
  }
}

3. create_slide

创建新的幻灯片页面

{
  "name": "create_slide",
  "arguments": {
    "options": {
      "masterSlideName": "MASTER_SLIDE",
      "sectionTitle": "Section Title"
    }
  }
}

4. add_slide

在指定位置插入幻灯片（支持详细配置参数）

参数说明：

• index：插入位置索引（必需）
• background：幻灯片背景设置
  • color：背景颜色（十六进制颜色代码，如 "F1F1F1"）
  • transparency：背景透明度（0-100）
  • data：背景图片的 base64 数据
  • path：背景图片的 URL 或文件路径
• color：幻灯片默认文本颜色（十六进制颜色代码）
• hidden：是否隐藏幻灯片
• slideNumber：幻灯片编号设置
  • x, y：位置（英寸或百分比）
  • w, h：尺寸（英寸或百分比）
  • fontFace：字体名称
  • fontSize：字体大小
  • color：字体颜色
  • align：对齐方式（left/center/right）
• masterName：使用的幻灯片母版名称

详细配置示例：

{
  "name": "add_slide",
  "arguments": {
    "index": 2,
    "background": {
      "color": "FF5733",
      "transparency": 20
    },
    "color": "333333",
    "slideNumber": {
      "x": 10,
      "y": 10,
      "fontFace": "Arial",
      "fontSize": 12,
      "color": "FFFFFF",
      "align": "center"
    }
  }
}

背景图片示例：

{
  "name": "add_slide",
  "arguments": {
    "index": 3,
    "background": {
      "path": "/path/to/background.jpg"
    },
    "hidden": true,
    "masterName": "Custom Master"
  }
}

简单插入示例：

{
  "name": "add_slide",
  "arguments": {
    "index": 1
  }
}

5. delete_slide

删除指定的幻灯片

{
  "name": "delete_slide",
  "arguments": {
    "index": 1
  }
}

6. add_text

向当前幻灯片添加文本

参数说明：

• 文本内容：
  • text: 文本内容（支持字符串或文本对象数组）
    • 字符串：简单文本
    • 数组：支持逐词/逐行格式化的文本对象数组
• 位置和尺寸：
  • x: 水平位置（英寸数值或百分比字符串，如 1.5 或 "50%"，默认：1.0）
  • y: 垂直位置（英寸数值或百分比字符串，如 1.0 或 "25%"，默认：1.0）
  • w: 宽度（英寸数值或百分比字符串，如 4.0 或 "50%"，默认：1.0）
  • h: 高度（英寸数值或百分比字符串，如 3.0 或 "40%"，默认：1.0）
• 字体和格式：
  • fontSize: 默认字体大小（磅，默认：12）
  • fontFace: 默认字体名称（如 "Arial", "Times New Roman"）
  • color: 默认字体颜色（十六进制，不含#，如 "FF0000"）
  • bold: 是否加粗（默认：false）
  • italic: 是否斜体（默认：false）
  • underline: 是否下划线（默认：false）
• 对齐方式：
  • align: 水平对齐方式（left/center/right/justify，默认：left）
  • valign: 垂直对齐方式（top/middle/bottom，默认：top）
• 背景和边框：
  • fill: 文本框背景填充
    • color: 背景颜色（十六进制，不含#）
    • transparency: 背景透明度（0-100）
• 内边距和间距：
  • margin: 内边距（数值或 [上,右,下,左] 数组）
  • paraSpaceBefore: 段落前间距（磅，默认：0）
  • paraSpaceAfter: 段落后间距（磅，默认：0）
• 项目符号：
  • bullet: 项目符号配置
    • 布尔值：是否使用默认项目符号
    • 对象：自定义项目符号配置
      • type: 项目符号类型（bullet/number）
      • code: 自定义 Unicode 代码（如 "2605" 为星号）
      • style: 编号样式
      • startAt: 编号起始值（默认：1）
• 超链接：
  • hyperlink: 超链接配置
    • url: 链接 URL
    • slide: 链接到的幻灯片编号
    • tooltip: 鼠标悬停提示文本
• 特殊效果：
  • shadow: 文字阴影效果
    • type: 阴影类型（outer/inner/none，默认：none）
    • angle: 阴影角度（度，默认：45）
    • blur: 阴影模糊度（磅，默认：3）
    • color: 阴影颜色（十六进制，不含#，默认："696969"）
    • offset: 阴影偏移距离（磅，默认：3）
    • opacity: 阴影透明度（0-1，默认：0.75）
  • outline: 文字轮廓效果
    • size: 轮廓粗细（磅，默认：1）
    • color: 轮廓颜色（十六进制，不含#）
• 文本框属性：
  • isTextBox: 是否创建为文本框（默认：false）
  • rotate: 旋转角度（0-359 度，默认：0）
  • flipH: 是否水平翻转（默认：false）
  • flipV: 是否垂直翻转（默认：false）

使用示例：

1. 基础文本：

{
  "name": "add_text",
  "arguments": {
    "text": "Hello World",
    "x": 1,
    "y": 1,
    "w": 5,
    "h": 1,
    "fontSize": 18,
    "color": "363636",
    "bold": true,
    "align": "center"
  }
}

2. 带样式的文本：

{
  "name": "add_text",
  "arguments": {
    "text": "重要通知",
    "x": 2,
    "y": 2,
    "w": 4,
    "h": 2,
    "fontSize": 24,
    "fontFace": "Arial",
    "color": "FFFFFF",
    "bold": true,
    "align": "center",
    "valign": "middle",
    "fill": {
      "color": "FF6B6B",
      "transparency": 20
    },
    "shadow": {
      "type": "outer",
      "color": "000000",
      "blur": 5,
      "offset": 3,
      "opacity": 0.5
    },
    "margin": 10
  }
}

3. 多格式文本数组：

{
  "name": "add_text",
  "arguments": {
    "text": [
      {
        "text": "标题：",
        "options": {
          "fontSize": 20,
          "bold": true,
          "color": "0066CC"
        }
      },
      {
        "text": "这是正文内容，",
        "options": {
          "fontSize": 14,
          "color": "333333"
        }
      },
      {
        "text": "这是重点强调的部分。",
        "options": {
          "fontSize": 14,
          "bold": true,
          "color": "FF0000",
          "underline": true
        }
      }
    ],
    "x": 1,
    "y": 3,
    "w": 6,
    "h": 2
  }
}

4. 项目符号列表：

{
  "name": "add_text",
  "arguments": {
    "text": "第一项\n第二项\n第三项",
    "x": 1,
    "y": 1,
    "w": 5,
    "h": 3,
    "fontSize": 16,
    "bullet": {
      "type": "bullet",
      "code": "2022"
    }
  }
}

5. 超链接文本：

{
  "name": "add_text",
  "arguments": {
    "text": "点击访问官网",
    "x": 2,
    "y": 4,
    "w": 3,
    "h": 1,
    "fontSize": 14,
    "color": "0066CC",
    "underline": true,
    "hyperlink": {
      "url": "https://www.example.com",
      "tooltip": "访问官方网站"
    }
  }
}

7. add_image

向当前幻灯片添加图片

参数说明：

• 数据源（二选一）：
  • path: 图片文件路径或 URL（支持相对路径、绝对路径、网络 URL）
  • data: 图片的 base64 编码数据（格式："image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."）
• 位置和尺寸：
  • x: 水平位置（英寸数值或百分比字符串，如 1.5 或 "50%"，默认：1.0）
  • y: 垂直位置（英寸数值或百分比字符串，如 1.0 或 "25%"，默认：1.0）
  • w: 宽度（英寸数值或百分比字符串，如 4.0 或 "50%"，默认：1.0）
  • h: 高度（英寸数值或百分比字符串，如 3.0 或 "40%"，默认：1.0）
• 图片属性：
  • altText: 图片的替代文本（用于无障碍访问）
  • flipH: 是否水平翻转图片（默认：false）
  • flipV: 是否垂直翻转图片（默认：false）
  • rotate: 旋转角度（0-359 度，默认：0）
  • rounding: 是否将图片裁剪为圆形（默认：false）
  • transparency: 透明度（0-100，0 表示完全不透明，100 表示完全透明，默认：0）
• 超链接：
  • hyperlink: 为图片添加超链接
    • url: 链接 URL
    • slide: 链接到的幻灯片编号（内部链接）
    • tooltip: 鼠标悬停时显示的提示文本
• 占位符：
  • placeholder: 占位符位置（如 "title", "body", "content" 等）
• 图片尺寸调整：
  • sizing: 图片尺寸调整和裁剪设置
    • type: 尺寸调整类型（"crop", "contain", "cover"）
    • w: 调整区域宽度（英寸）
    • h: 调整区域高度（英寸）
    • x: 裁剪起始 X 坐标（仅 crop 类型有效，默认：0）
    • y: 裁剪起始 Y 坐标（仅 crop 类型有效，默认：0）
• 阴影效果：
  • shadow: 图片阴影效果设置
    • type: 阴影类型（"outer", "inner", "none"，默认："outer"）
    • angle: 阴影角度（度，默认：45）
    • blur: 阴影模糊度（磅，默认：3）
    • color: 阴影颜色（十六进制，如 "808080"，默认："808080"）
    • offset: 阴影偏移距离（磅，默认：3）
    • opacity: 阴影透明度（0-1，默认：0.75）

使用示例：

1. 详细配置的图片：

{
  "name": "add_image",
  "arguments": {
    "path": "https://example.com/image.jpg",
    "x": 1.0,
    "y": 1.0,
    "w": 4.0,
    "h": 3.0,
    "altText": "示例图片",
    "rotate": 15,
    "transparency": 10,
    "hyperlink": {
      "url": "https://example.com",
      "tooltip": "点击访问网站"
    },
    "shadow": {
      "type": "outer",
      "angle": 45,
      "blur": 5,
      "color": "808080",
      "offset": 4,
      "opacity": 0.8
    }
  }
}

2. 圆形头像图片：

{
  "name": "add_image",
  "arguments": {
    "path": "./avatar.png",
    "x": 6.0,
    "y": 1.0,
    "w": 2.0,
    "h": 2.0,
    "rounding": true,
    "altText": "用户头像"
  }
}

3. Base64 编码图片：

{
  "name": "add_image",
  "arguments": {
    "data": "image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "x": "25%",
    "y": "50%",
    "w": "50%",
    "h": "30%"
  }
}

4. 带裁剪的图片：

{
  "name": "add_image",
  "arguments": {
    "path": "./large-image.jpg",
    "x": 1.0,
    "y": 4.0,
    "w": 3.0,
    "h": 2.0,
    "sizing": {
      "type": "crop",
      "w": 3.0,
      "h": 2.0,
      "x": 100,
      "y": 50
    }
  }
}

8. add_chart

向当前幻灯片添加图表

参数说明：

• type: 图表类型（必需）
  • 支持的类型：area, bar, bar3D, bubble, doughnut, line, pie, pie3D, radar, scatter
• data: 图表数据数组（必需）
  • name: 数据系列名称
  • labels: 数据标签数组
  • values: 数据值数组
• options: 图表配置选项（可选）
  • 位置和尺寸：
    • x, y: 图表位置（英寸）
    • w, h: 图表宽度和高度（英寸）
  • 标题配置：
    • title: 图表标题
    • showTitle: 是否显示标题
    • titleFontFace, titleFontSize, titleColor: 标题字体样式
  • 图例配置：
    • showLegend: 是否显示图例
    • legendPos: 图例位置（t, b, l, r）
  • 颜色和样式：
    • chartColors: 自定义颜色数组
    • chartColorsOpacity: 颜色透明度（0-100）
  • 柱状图特有：
    • barDir: 方向（bar 或 col）
    • barGrouping: 分组方式（clustered, stacked, percentStacked）
    • barGapWidthPct: 柱间距百分比
  • 饼图特有：
    • showPercent: 显示百分比
    • holeSize: 环形图内径百分比
  • 数据标签：
    • showDataLabels: 显示数据标签
    • dataLabelColor, dataLabelFontSize: 数据标签样式
  • 坐标轴：
    • catAxisTitle, valAxisTitle: 坐标轴标题
    • showCatAxisTitle, showValAxisTitle: 是否显示坐标轴标题
  • 图表区域：
    • chartArea: 图表区域样式（fill, border）
    • plotArea: 绘图区域样式

使用示例：

1. 详细配置的柱状图：

{
  "name": "add_chart",
  "arguments": {
    "type": "bar",
    "data": [
      {
        "name": "实际销售",
        "labels": ["Q1", "Q2", "Q3", "Q4"],
        "values": [1500, 2300, 1800, 2800]
      },
      {
        "name": "预期销售",
        "labels": ["Q1", "Q2", "Q3", "Q4"],
        "values": [1200, 2000, 2200, 2500]
      }
    ],
    "options": {
      "x": 1,
      "y": 1,
      "w": 8,
      "h": 5,
      "title": "季度销售对比",
      "showTitle": true,
      "titleFontSize": 18,
      "titleColor": "0066CC",
      "showLegend": true,
      "legendPos": "b",
      "chartColors": ["0088CC", "FF6600"],
      "barDir": "col",
      "barGrouping": "clustered",
      "showDataLabels": true,
      "catAxisTitle": "季度",
      "valAxisTitle": "销售额（万元）"
    }
  }
}

2. 简单饼图：

{
  "name": "add_chart",
  "arguments": {
    "type": "pie",
    "data": [
      {
        "name": "市场份额",
        "labels": ["产品A", "产品B", "产品C", "其他"],
        "values": [35, 25, 20, 20]
      }
    ],
    "options": {
      "x": 1,
      "y": 1,
      "w": 6,
      "h": 4,
      "showPercent": true,
      "showLegend": true,
      "chartColors": ["FF6B6B", "4ECDC4", "FFE66D", "A8E6CF"]
    }
  }
}

3. 基础折线图：

{
  "name": "add_chart",
  "arguments": {
    "type": "line",
    "data": [
      {
        "name": "趋势数据",
        "labels": ["1月", "2月", "3月", "4月", "5月"],
        "values": [10, 25, 18, 32, 28]
      }
    ],
    "options": {
      "x": 1,
      "y": 1,
      "w": 7,
      "h": 4
    }
  }
}

9. add_table

向当前幻灯片添加表格

参数配置：

表格数据（必需）：

• rows: 表格行数据数组，每行包含单元格数据（字符串或对象）

位置和尺寸：

• x: 水平位置（英寸，从幻灯片左边缘开始）
• y: 垂直位置（英寸，从幻灯片顶部开始）
• w: 表格宽度（英寸）
• h: 表格高度（英寸）

列宽和行高：

• colW: 各列宽度数组（英寸）
• rowH: 各行高度数组（英寸）

表格样式：

• align: 表格对齐方式（"left", "center", "right"）
• border: 边框设置（type, pt, color）
• color: 默认文字颜色（十六进制，不含#）
• fill: 默认背景色（十六进制，不含#）
• fontFace: 默认字体名称
• fontSize: 默认字体大小（磅）
• margin: 默认单元格内边距（磅）
• valign: 默认垂直对齐方式（"top", "middle", "bottom"）

单元格对象格式：

• text: 单元格文本内容
• options: 单元格样式选项（align, valign, bold, italic, underline, fontSize, fontFace, color, fill, margin, colspan, rowspan）

使用示例：

1. 基础表格：

{
  "name": "add_table",
  "arguments": {
    "rows": [
      ["产品", "Q1销售", "Q2销售", "增长率"],
      ["产品A", "100万", "120万", "20%"],
      ["产品B", "80万", "95万", "18.75%"],
      ["产品C", "60万", "75万", "25%"]
    ],
    "x": 1,
    "y": 1,
    "w": 8,
    "h": 3
  }
}

2. 带样式的表格：

{
  "name": "add_table",
  "arguments": {
    "rows": [
      ["季度", "销售额", "利润"],
      ["Q1", "500万", "50万"],
      ["Q2", "600万", "65万"],
      ["Q3", "550万", "58万"]
    ],
    "x": 1,
    "y": 2,
    "w": 6,
    "h": 2.5,
    "colW": [1.5, 2, 2.5],
    "border": {
      "type": "solid",
      "pt": 1,
      "color": "333333"
    },
    "fontFace": "Arial",
    "fontSize": 12,
    "align": "center",
    "valign": "middle"
  }
}

3. 复杂单元格表格：

{
  "name": "add_table",
  "arguments": {
    "rows": [
      [
        {
          "text": "产品名称",
          "options": {
            "bold": true,
            "fill": "4472C4",
            "color": "FFFFFF",
            "align": "center"
          }
        },
        {
          "text": "销售数据",
          "options": {
            "bold": true,
            "fill": "4472C4",
            "color": "FFFFFF",
            "align": "center",
            "colspan": 2
          }
        }
      ],
      [
        "产品A",
        {
          "text": "150万",
          "options": {
            "align": "right",
            "color": "0066CC"
          }
        },
        {
          "text": "↑15%",
          "options": {
            "align": "center",
            "color": "00AA00",
            "bold": true
          }
        }
      ]
    ],
    "x": 1,
    "y": 1,
    "w": 6,
    "h": 2
  }
}

10. add_media

向当前幻灯片添加媒体内容（音频/视频/在线视频） <mcreference link="https://gitbrent.github.io/PptxGenJS/docs/api-media/" index="1">1</mcreference>

参数配置：

媒体源（必须提供其中之一）：

• type: 媒体类型（"audio", "video", "online"）
• path: 媒体文件路径（本地路径或网络 URL）
• data: 媒体的 base64 编码数据（格式："audio/mp3;base64,iVtDafDrBF..."）
• link: YouTube 嵌入 URL（用于在线视频，格式："https://www.youtube.com/embed/VIDEO_ID"）

位置和尺寸（必需）：

• x: 水平位置（英寸，从幻灯片左边缘开始）
• y: 垂直位置（英寸，从幻灯片顶部开始）
• w: 宽度（英寸）
• h: 高度（英寸）

媒体选项（可选）：

• cover: 封面图片路径或 base64 数据（用于媒体预览）
• volume: 音量级别（0-100，适用于音频/视频）
• autoPlay: 是否在显示幻灯片时自动播放媒体（默认：false）
• loop: 是否循环播放媒体（默认：false）
• showControls: 是否显示媒体播放器控件（默认：true）

使用示例：

1. 添加视频文件（带完整配置）：

{
  "name": "add_media",
  "arguments": {
    "type": "video",
    "path": "https://example.com/sample.mp4",
    "x": 1.0,
    "y": 1.0,
    "w": 6.0,
    "h": 4.0,
    "cover": "https://example.com/cover.jpg",
    "volume": 75,
    "autoPlay": false,
    "loop": true,
    "showControls": true
  }
}

2. 添加音频文件（Base64 编码）：

{
  "name": "add_media",
  "arguments": {
    "type": "audio",
    "data": "audio/mp3;base64,iVtDafDrBF[...]",
    "x": 8.0,
    "y": 1.0,
    "w": 3.0,
    "h": 2.0,
    "volume": 50,
    "autoPlay": true
  }
}

3. 添加 YouTube 在线视频：

{
  "name": "add_media",
  "arguments": {
    "type": "online",
    "link": "https://www.youtube.com/embed/Dph6ynRVyUc",
    "x": 1.0,
    "y": 5.5,
    "w": 8.0,
    "h": 4.5,
    "showControls": false
  }
}

4. 添加本地音频文件（简单配置）：

{
  "name": "add_media",
  "arguments": {
    "type": "audio",
    "path": "../media/background.mp3",
    "x": 0.5,
    "y": 0.5,
    "w": 2.0,
    "h": 1.0
  }
}

11. add_shape

向当前幻灯片添加形状 <mcreference link="https://gitbrent.github.io/PptxGenJS/docs/api-shapes/" index="2">2</mcreference>

参数配置：

形状类型和位置（必需）：

• shapeType: 形状类型（如 "rect"、"ellipse"、"line"、"triangle"、"diamond"、"pentagon"、"hexagon"、"star"、"arrow" 等）
• x: 水平位置（英寸，从幻灯片左边缘开始）
• y: 垂直位置（英寸，从幻灯片顶部开始）
• w: 宽度（英寸）
• h: 高度（英寸）

填充样式（可选）：

• fill: 形状填充样式
  • type: 填充类型（"solid" 或 "none"，默认："solid"）
  • color: 填充颜色（十六进制颜色代码，如 "FF0000"）
  • transparency: 填充透明度（0-100）

线条样式（可选）：

• line: 形状边框线条样式
  • color: 线条颜色（十六进制颜色代码，如 "000000"）
  • width: 线条宽度（磅，默认：1）
  • dashType: 线条样式类型（"solid"、"dash"、"dashDot" 等，默认："solid"）
  • beginArrowType: 线条起始箭头类型（"none"、"triangle"、"stealth"、"diamond"、"oval"，默认："none"）
  • endArrowType: 线条结束箭头类型（"none"、"triangle"、"stealth"、"diamond"、"oval"，默认："none"）

阴影效果（可选）：

• shadow: 形状阴影效果
  • type: 阴影类型（"outer"、"inner"、"none"，默认："none"）
  • angle: 阴影角度（度，默认：45）
  • blur: 阴影模糊度（磅，默认：3）
  • color: 阴影颜色（十六进制颜色代码，如 "808080"，默认："808080"）
  • offset: 阴影偏移距离（磅，默认：3）
  • opacity: 阴影透明度（0-1，默认：0.75）

变换效果（可选）：

• rotate: 旋转角度（度，0-360）
• flipH: 是否水平翻转（默认：false）
• flipV: 是否垂直翻转（默认：false）

使用示例：

1. 添加带样式的矩形：

{
  "name": "add_shape",
  "arguments": {
    "shapeType": "rect",
    "x": 1.0,
    "y": 1.0,
    "w": 4.0,
    "h": 2.0,
    "fill": {
      "type": "solid",
      "color": "4472C4",
      "transparency": 20
    },
    "line": {
      "color": "2F5597",
      "width": 2,
      "dashType": "solid"
    },
    "shadow": {
      "type": "outer",
      "angle": 45,
      "blur": 4,
      "color": "808080",
      "offset": 3,
      "opacity": 0.6
    }
  }
}

2. 添加圆形（椭圆）：

{
  "name": "add_shape",
  "arguments": {
    "shapeType": "ellipse",
    "x": 6.0,
    "y": 1.0,
    "w": 2.0,
    "h": 2.0,
    "fill": {
      "type": "solid",
      "color": "FF6B6B"
    },
    "line": {
      "color": "E55555",
      "width": 3
    }
  }
}

3. 添加带箭头的直线：

{
  "name": "add_shape",
  "arguments": {
    "shapeType": "line",
    "x": 1.0,
    "y": 4.0,
    "w": 6.0,
    "h": 0.1,
    "line": {
      "color": "000000",
      "width": 2,
      "endArrowType": "triangle"
    }
  }
}

4. 添加旋转的星形：

{
  "name": "add_shape",
  "arguments": {
    "shapeType": "star",
    "x": 3.0,
    "y": 5.0,
    "w": 2.0,
    "h": 2.0,
    "fill": {
      "type": "solid",
      "color": "FFD700"
    },
    "rotate": 30,
    "shadow": {
      "type": "outer",
      "color": "FFA500",
      "opacity": 0.8
    }
  }
}

5. 添加无填充的三角形：

{
  "name": "add_shape",
  "arguments": {
    "shapeType": "triangle",
    "x": 7.0,
    "y": 4.0,
    "w": 2.0,
    "h": 2.0,
    "fill": {
      "type": "none"
    },
    "line": {
      "color": "0066CC",
      "width": 3,
      "dashType": "dash"
    }
  }
}

12. save_ppt

保存 PowerPoint 文件，支持多种输出格式和配置选项

参数配置：

基本保存选项：

• fileName (string): 输出文件名（包含扩展名），默认 "Presentation.pptx"
• filePath (string): 完整文件路径（优先级高于 fileName）

压缩选项：

• compression (boolean): 是否应用 ZIP 压缩，默认 false（导出时间更长但节省空间）

输出格式选项：

• outputType (string): 输出格式类型，默认 "file"
  • file: 保存为文件
  • arraybuffer: 返回 ArrayBuffer
  • base64: 返回 Base64 字符串
  • binarystring: 返回二进制字符串
  • blob: 返回 Blob 对象
  • nodebuffer: 返回 Node.js Buffer
  • uint8array: 返回 Uint8Array
  • stream: 流式输出（仅 Node.js）

流式输出选项（仅 Node.js 环境）：

• streamOptions (object): 流式输出配置
  • port (number): HTTP 服务器端口，默认 3000
  • endpoint (string): HTTP 端点路径，默认 "/"
  • contentDisposition (string): Content-Disposition 头部值，默认 "attachment"

返回选项：

• returnData (boolean): 是否在响应中返回文件数据，默认 false
• dataPreviewLength (number): 返回数据预览的字符长度，默认 100（0 表示不预览）

使用示例：

// 1. 基本文件保存
{
  "name": "save_ppt",
  "arguments": {
    "fileName": "my-presentation.pptx"
  }
}

// 2. 指定完整路径保存
{
  "name": "save_ppt",
  "arguments": {
    "filePath": "/Users/username/Documents/presentation.pptx",
    "compression": true
  }
}

// 3. 导出为 Base64 格式
{
  "name": "save_ppt",
  "arguments": {
    "outputType": "base64",
    "compression": true,
    "returnData": true,
    "dataPreviewLength": 200
  }
}

// 4. 导出为 ArrayBuffer
{
  "name": "save_ppt",
  "arguments": {
    "outputType": "arraybuffer",
    "returnData": false
  }
}

// 5. 流式输出（Node.js）
{
  "name": "save_ppt",
  "arguments": {
    "outputType": "stream",
    "streamOptions": {
      "port": 8080,
      "endpoint": "/download",
      "contentDisposition": "attachment; filename=presentation.pptx"
    }
  }
}

工作流程示例

// 1. 创建新的 PPT
{"name": "create_ppt", "arguments": {}}

// 2. 创建第一张幻灯片
{"name": "create_slide", "arguments": {}}

// 3. 添加标题文本
{
  "name": "add_text",
  "arguments": {
    "text": "我的演示文稿",
    "options": {
      "x": 1, "y": 1, "w": 8, "h": 1,
      "fontSize": 24, "bold": true, "align": "center"
    }
  }
}

// 4. 添加内容文本
{
  "name": "add_text",
  "arguments": {
    "text": "这是演示文稿的内容",
    "options": {
      "x": 1, "y": 3, "w": 8, "h": 2,
      "fontSize": 16
    }
  }
}

// 5. 保存文件
{"name": "save_ppt", "arguments": {"filePath": "my-presentation.pptx"}}

注意事项

1. 会话状态：服务器维护当前 PPT 和幻灯片的状态，所有操作都作用于当前活动的 PPT 和幻灯片。

2. 幻灯片切换：调用 create_slide 或 add_slide 会切换到新的幻灯片，后续的内容添加操作都会作用于这张幻灯片。

3. 文件路径：确保提供的文件路径是有效的，图片和媒体文件需要存在于指定路径。

4. 坐标系统：PptxGenJS 使用英寸作为单位，坐标原点在左上角。

5. 限制：由于 PptxGenJS 的限制，某些功能（如删除幻灯片、读取现有文件内容）可能不完全支持。

配置示例

STDIO 模式配置

在你的 MCP 客户端配置中添加：

{
  "mcpServers": {
    "pptxgenjs": {
      "command": "node",
      "args": ["/path/to/your/pptxgenjs-mcp/dist/index.js"],
      "cwd": "/path/to/your/pptxgenjs-mcp",
      "env": {}
    }
  }
}

SSE 模式配置

在你的 MCP 客户端配置中添加：

{
  "mcpServers": {
    "pptxgenjs": {
      "command": "node",
      "args": ["/path/to/your/pptxgenjs-mcp/dist/index.js", "--mode=sse", "--port=3000"],
      "cwd": "/path/to/your/pptxgenjs-mcp",
      "env": {}
    }
  }
}

或者直接通过 HTTP 连接到 http://localhost:3000/sse

依赖项

• @modelcontextprotocol/sdk: MCP SDK
• pptxgenjs: PowerPoint 生成库
• typescript: TypeScript 支持

许可证

MIT