Markdown转PPT服务

一个强大的模型上下文协议(MCP)服务器,一键将Markdown文本转换为精美且高度精确的PPTX和PDF演示文稿。

  • by Hronrad
  • CSS
  • 本地部署
  • 更新于
在 GitHub 查看 Hronrad/marp-fast_ppt_maker-mcp

使用说明

Marp快速PPT制作MCP服务器

这是一个功能强大的模型上下文协议(MCP)服务器,只需单击一下,即可将任何Markdown文本转换为格式精美、高度精确的PPTX和PDF演示文稿。

其核心创新是 双通道物理探针测量引擎通过放弃传统的字符计数估计,它利用无头浏览器来执行真正的DOM像素级测量。这完全解决了幻灯片内容溢出、数学公式截断和布局损坏等痛点。

核心功能

  • 物理级别防溢出:使用Chromium引擎测量真实渲染高度,100%防止文本溢出幻灯片边界。
  • 语义感知拆分:优先考虑高级标题的语义分页符,保持人类阅读的逻辑连贯性。
  • 电池级元件保护:自动修复跨页面的Markdown表(自动完成标题)和列表结构(自动恢复缩进和注入父上下文),防止LaTeX数学渲染失败。
  • 多主题支持:内置 default, gaia,以及 uncover 主题,支持安装本地 themes 文件夹以扩展社区主题(例如。, academic, rose-pine).
  • 完全跨平台:与Windows、macOS和Linux完全兼容。

先决条件

  1. Python 3.10+
  2. Node.js (用于运行Marp CLI)
  3. 谷歌Chrome浏览器或微软Edge浏览器 (本地安装;程序将自动检测路径,无需手动下载)

安装指南

1.安装Python依赖项

建议在虚拟环境中运行此程序:

python -m venv venv
# Windows activation: venv\Scripts\activate
# macOS/Linux activation: source venv/bin/activate
pip install -r requirements.txt

(注意:由于此程序会自动调用系统安装的Chrome/Edge,您不需要手动运行剧作家安装chromium)

2.安装Marp CLI(Node.js)

在项目根目录中安装本地Marp依赖项:

npm install

运行和使用

通过MCP检查器进行调试和运行:

npx @modelcontextprotocol/inspector ./venv/bin/python -u server.py

或者,在MCP支持的客户端(如Claude Desktop)的配置文件中配置此服务器:

{
  "mcpServers": {
    "Marp-PPT-Maker": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-u", "/absolute/path/to/server.py"]
    }
  }
}

输出工件

生成的.md中间文件、.pptx和.pdf最终文件将自动保存在项目根目录中的output_slides文件夹中。

相关链接

许可证

麻省理工学院