SlideForge

mcp-name: dev.slideforge/slideforge

SlideForge MCP — 面向 AI Agent 的 PowerPoint 幻灯片

SlideForge（slideforge.dev）——面向 AI Agent 的确定性 PowerPoint 编译器。 输入类型化幻灯片意图 → 不到一秒即可生成原生、完全可编辑的 .pptx，并附带保真度清单，明确说明哪些内容是逐字绑定的。由瑞士的 Smart Data Brokers GmbH 构建。

远程 MCP 服务 + REST API。无需本地安装，无需 Python 环境，也无需编写 python-pptx 样板代码。Claude Desktop 和 ChatGPT 使用 OAuth 2.1；其他所有场景使用 API 密钥。

---

⚠️ 消歧说明

多个互不相关的项目都使用了“SlideForge”这一名称。这是 Smart Data Brokers GmbH 的 SlideForge，网址为 slideforge.dev。 与以下项目无关：

• slideforge.io — 一个独立的 AI 演示文稿生成器
• slideforge.fr — 一项法语文档润色服务
• blink.new/p/slideforge-app — 一个无关的 Web 应用
• smartdatabrokers 组织之外其他 github.com/*/SlideForge 仓库

引用或链接时，请优先使用 slideforge.dev 或“Smart Data Brokers 的 SlideForge”。

---

为什么选择 SlideForge

• 它是编译器，而不是生成器。 幻灯片是类型化意图：从 200 多种目录模式中选择一个 form（KPI 仪表板、瀑布图、甘特计划、组织结构图、漏斗图等），将实际内容填入类型化字段。确定性引擎负责排版——渲染流程中不使用大模型，相同输入 → 相同幻灯片，耗时不到一秒。
• 诚实保障层。 每个响应都包含一份保真度清单：逐字段说明你的内容是以 verbatim（逐字）、mixed（混合）还是 ai_completed（AI 补全）方式绑定的。partial 等级表示部分提供的内容未能呈现在幻灯片上——清单会列出被省略的内容；如果不告知用户缺少了什么，就绝不要交付 partial 渲染结果。存在阻塞性缺陷的幻灯片不收费（可用才收费）。如果你的 Agent 会将数字填入幻灯片，这正是让输出可审计的关键。
• 原生、可编辑的 .pptx。 使用真实形状和文本框——不是图片，也不是 HTML 导出文件。可在 PowerPoint 中打开和编辑。
• 内置退路，且遵循相同的信任约定。 mode=code 可在沙箱中运行你自己的 python-pptx（配备组件/图表工具包，注入主题，意图字段渲染为装饰元素）。代码渲染结果会经过 lint 检查、度量（layout 块 + presentation_ready）和来源验证——Agent 可以跳出布局语法，但不能跳出信任语法。
• 原生支持你的模板。 上传公司的 .pptx——幻灯片直接基于你的文件构建（主题、母版、字体），而不是仿制配色。
• 免费检查。 dry_run 可验证任意载荷并预测保真度，费用为 $0；也可使用 mode=safe，在一次调用中先验证再渲染（只有忠实呈现才会渲染并收费；否则返回一份 $0 报告并说明如何修正）。代码渲染结果可通过 verify 分级检查（默认 lint，lint+vlm 会额外进行一次视觉复核）。quality_profile（executive/technical/appendix）可设置布局评判所依据的就绪度标准——适用于任何 form。免费演示文稿检查（POST /v1/inspect）可对任意 pptx 运行确定性质量报告。
• 根据我们自己的盲测对比，质量与 Gamma 相当，达到 97%（内部评测，非第三方）。

一句话说清定价：创建一张幻灯片 5¢ · 转换一张幻灯片 2¢（翻译、修复）· 检查免费。 注册即送 60 张免费幻灯片，无需订阅。slideforge.dev/pricing

---

快速开始

一键安装，无需配置文件：

 

VS Code（Copilot Agent 模式）首次使用时会通过 OAuth 登录，无需密钥或 JSON 文件。

Cursor 安装时会使用 API 密钥占位符：点击后，将服务的 headers 中的 sf_live_YOUR_KEY 替换为从控制台获取的真实密钥。截至 3.16.17，Cursor 自带的 OAuth 浏览器启动功能存在问题，因此目前可用的方式是使用密钥。

Claude Code

claude mcp add --transport http slideforge https://api.slideforge.dev/mcp/

然后只需提出请求：“制作一张 KPI 仪表盘幻灯片：营收为 $12.4M（同比增长 18%），新增客户 847 位，NPS 为 62。”

可选 — 将技能和捆绑的服务配置作为插件安装：

/plugin marketplace add smartdatabrokers/slideforge-mcp
/plugin install slideforge@slideforge-mcp

或者，将 skills/ 中的任意文件夹复制到 ~/.claude/skills/（个人）或 .claude/skills/（项目）。

Claude Desktop（OAuth — 无需密钥）

设置 → 连接器 → 添加自定义连接器 → https://api.slideforge.dev/mcp/ — 首次使用时使用 Google 账号登录。

ChatGPT（开发者模式）

设置 → 应用 → 高级 → 开发者模式 → 添加自定义连接器 → https://api.slideforge.dev/mcp/（OAuth）。

Cursor / Windsurf / Codex CLI / 任意 MCP 客户端（API 密钥）

{
  "mcpServers": {
    "slideforge": {
      "url": "https://api.slideforge.dev/mcp/",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer sf_live_YOUR_KEY" }
    }
  }
}

获取密钥：slideforge.dev → 控制台 → API 密钥。（Codex CLI 和其他原生支持 AGENTS.md 的工具：参阅 AGENTS.md。）

在本地运行（stdio — 适用于容器/离线客户端）

大多数客户端应使用上方托管的远程服务（无需安装）。但如果客户端从容器或本地 stdio 进程启动 MCP 服务，请运行捆绑的本地服务。它是一个针对 api.slideforge.dev 的轻量 REST 客户端，不包含引擎逻辑；工具架构预先内置在本地（因此可离线发现，无需密钥），每次调用都会使用你的密钥进行身份验证，并转发到 SlideForge REST API。

pip install slideforge-mcp        # or: uv pip install slideforge-mcp
export SLIDEFORGE_API_KEY=sf_live_YOUR_KEY
slideforge-mcp                    # speaks MCP over stdio

或者通过 Docker 运行：

docker build -t slideforge-mcp .
docker run -i -e SLIDEFORGE_API_KEY=sf_live_YOUR_KEY slideforge-mcp

客户端配置（stdio）：

{
  "mcpServers": {
    "slideforge": {
      "command": "slideforge-mcp",
      "env": { "SLIDEFORGE_API_KEY": "sf_live_YOUR_KEY" }
    }
  }
}

架构发现（tools/list）无需密钥或网络；调用工具则需要密钥。

LangChain / LlamaIndex（Agent 框架）

无需 SlideForge SDK — 两者都可以直接加载 MCP 工具：

pip install langchain-mcp-adapters      # or: pip install llama-index-tools-mcp

from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"slideforge": {
    "transport": "streamable_http",
    "url": "https://api.slideforge.dev/mcp/",
    "headers": {"Authorization": f"Bearer {API_KEY}"}}})
tools = await client.get_tools()        # 7 tools, drop into any LangGraph agent

可运行示例及 LlamaIndex 对应示例：examples/。 需要密钥？注册 — 免费制作 60 张幻灯片，无需信用卡 — 然后前往 console/keys 获取密钥。

REST（非 MCP）

curl -X POST https://api.slideforge.dev/v1/render/intent \
  -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form": "kpi_metrics", "headline": "Q3 at a glance",
       "data": {"metrics": [{"label": "Revenue", "value": "$12.4M", "delta": "+18% YoY"},
                             {"label": "New clients", "value": "847"},
                             {"label": "NPS", "value": "62"}]}}'

完整 REST 参考：slideforge.dev/docs/api

---

7 个 MCP 工具

工具	功能	费用
create_slide	根据结构化意图（表单 + 类型化字段）或简要说明创建一张幻灯片；mode=safe 会在一次调用中先验证再渲染；mode=code 用于沙盒化的 python-pptx（验证层级、chrome 字段、按替换内容修补）。路由控制项：variant、variant_policy、allow_fabrication/allow_truncation/allow_low_confidence（诚实的默认行为：以 $0 拒绝，而不是猜测）。min_font_pt 设置有约束力的字体下限——只要文本框允许，文本就会增大以达到该下限；无法容纳的内容会返回 $0 的 min_font_not_met 错误，并指出所需字号。响应会携带保真度清单，以及图示表单的实测 layout 就绪状态区块。默认主题提供主题化设计——根据主题选择的配色和精心设计的封面，会在响应的设计说明中注明（styling: "clean" 可关闭；你固定使用或上传的品牌主题始终优先）。	$0.05（可用，否则免费）
create_deck	创建完整演示文稿：包含意图的 slides[]（代码模式幻灯片是一级子项），并行渲染，合并为一个 .pptx，提供逐页保真度汇总及逐页子任务（各自有预览和 pptx）。失败的幻灯片会单独处理且免费；演示文稿级别的 dry_run 会以 $0 验证整份演示文稿。演示文稿级别的 language、direction（阿拉伯语/希伯来语使用 rtl——文字从右向左排版，布局不镜像，并会如实发出警告）、imagery/imagery_tag、styling 和 logo_id 会继承到每张幻灯片；幻灯片自身设置的值优先。	N × $0.05
plan_slide	简要说明 → 最匹配的表单/变体候选项及其置信度。	免费
browse_catalog	提供 200 多种模式，包含每种表单对应的 JSON Schema、可复制粘贴的示例意图、主题和代码模式小组件工具包。传入已上传的 theme_id，即可列出其品牌化封面/议程/分隔页布局。type=brands 会列出你的品牌套件及其版本。提供 9 种内置主题和你上传的品牌套件。	免费
translate_deck	翻译任意 PPTX，同时保留格式（32 种语言）。	$0.02/页
upload_asset	上传徽标、品牌模板 PPTX、图像；purpose=pdf 可将 PDF 提取为可编辑的幻灯片意图（仅支持 PowerPoint/Keynote/Google-Slides/Beamer 导出的 PDF——暂不支持其他来源）；也可通过 AI 生成图像。默认情况下，上传品牌模板（purpose=brand——purpose=theme 是它的旧名称，仍可使用）会以 NATIVE 方式渲染——演示文稿将基于客户端自己的模板文件构建。对于大型文件，可省略 data，使用卡片内拖放区域。	免费 / $0.01/页 / $0.05/图像
manage_account	查看余额、用量、任务、安全状态和反馈；使用 action=feedback_list 读取你提交的报告，使用 action=brand_report 查看品牌套件逐令牌的保真度报告。	免费

在创建工具上设置 dry_run: true = 以 $0 完成验证 + 保真度预测。

另外还有两个工具（generate_report、manage_connections——基于已连接工具（如 Zoho Sprints）的数据生成报告）处于企业版权限控制之下，默认不提供。

目前也可通过 REST 使用：Deck Doctor。 POST /v1/inspect — 为任意 pptx 免费生成确定性的演示文稿质量报告（基于真实字体度量检测溢出、被形状遮挡的内容、画布外残留内容、WCAG 对比度）。POST /v1/repair — 确定性修复，绝不会改动你的文字；每张修复后的幻灯片收费 $0.02，干运行报价免费。文档

---

品牌套件

品牌套件是组织的身份标识——包括颜色、字体、徽标，以及（可选的）上传的 .pptx/.potx/.thmx 模板。它以 slug 形式存储，并在每次调用时应用。

• 使用品牌套件：传入 theme_id=<slug>，即可在 create_slide/create_deck 中使用套件的默认 版本；也可以传入 <slug>@<n>，指定特定版本。
• 创建品牌套件：upload_asset(purpose="brand", data=<base64 .pptx/.potx/.thmx>)——之后生成的演示文稿 将基于你自己的模板文件进行 NATIVE 渲染。（purpose="theme" 是使用旧名称的相同路径，仍可正常使用。）
• 查看品牌套件：browse_catalog(type="brands") 会列出你的套件及其版本。
• 检查保真度：manage_account(action="brand_report", theme_id=<slug>) 会返回套件的逐令牌保真度报告。
• 通过 URL 导出或导入：完整的套件 CRUD、DTCG tokens.json/.potx/.thmx 导出，以及 直接从公司域名导入品牌标识，目前仅支持 REST—— /v1/brands（尚未作为 MCP 工具提供）。

---

安全性

• 工具结果正文不包含凭据——响应中没有签名 URL。预览以内嵌方式提供 （Agent 会直接查看 PNG）；.pptx 通过标头身份验证下载 （Authorization: Bearer + 所有权检查），而不是通过 URL 中的 Bearer 令牌下载。
• 需要可分享的链接？POST /v1/jobs/<job_id>/download-url 会生成一个短时有效、 仅可使用一次、可撤销的链接。
• 生成的文件会在创建 30 天后自动删除。
• 每次下载都会记录审计日志。
• manage_account(action=security_status) 会在带内披露完整的安全态势。

---

Agent 技能（本仓库）

可直接复制的技能，用于指导 Agent 更好地使用 SlideForge——详见 skills/：

技能	用途
create-slide	以意图为先创建幻灯片/演示文稿、发现架构、试运行、保真度清单、无头预览
inspect-repair	为任意 pptx 免费生成演示文稿质量报告，并进行确定性修复
translate-pptx	保留格式的 PPTX 翻译
pdf-to-pptx	提取 PDF 内容并转换为可编辑的 PPTX

对于 Codex CLI / Cursor / Copilot 和其他原生支持 AGENTS.md 的工具， AGENTS.md 以可移植格式提供相同的指南。CLAUDE.md 会导入该文件，供 Claude Code 使用。

无头使用（Claude Code / Codex CLI）

终端中没有内嵌小组件，但工具结果已内嵌预览 PNG—— Agent 可直接从响应中读取，无需获取。.pptx 通过标头身份验证下载：

curl -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -o deck.pptx https://api.slideforge.dev/v1/jobs/<job_id>/pptx   # ownership-checked

如果要交接可分享的链接，而不是原始文件，可生成一个仅可使用一次的链接： POST /v1/jobs/<job_id>/download-url——短时有效、可撤销、仅可使用一次。

自我审查循环（渲染 → 查看内嵌预览 → 修复 → 重新渲染）详见 examples/claude-code.md。

---

对比

	SlideForge	python-pptx	仅靠提示词生成的 AI 演示文稿
可编辑的原生 .pptx	✅	✅	通常为图像/导出文件
确定性（相同输入 → 相同幻灯片）	✅	✅（你的代码）	❌
标明 AI 修改过的内容（保真度清单）	✅	不适用	❌
无需手动编码即可获得优质布局	✅ 200+ 种模式	❌ 需自行实现	因情况而异
托管式、原生支持 Agent（MCP + REST）	✅	❌ 本地	部分支持
免费预检验证	✅ dry_run	不适用	❌

---

链接

• 网站：slideforge.dev · 定价：/pricing · 信任与诚实层：/trust
• 文档：REST · MCP · 快速入门 · Deck Doctor
• Smithery：smartdatabrokers/slideforge
• X / Twitter：@slideforgedev

许可证

MIT（本仓库：技能、示例、文档）。SlideForge 服务本身是商业 API。