MCP Marp框架
该项目提供了一个模块化内容呈现(MCP)框架,该框架使用 马普 作为渲染引擎。它将以JSON或YAML表示的结构化课程数据转换为功能齐全的Marp Markdown,该Markdown与Marp CLI和VS Code扩展工作流完全兼容。
特性
- 模块化解析器,将课程数据映射到可重用的幻灯片模板,同时保留Marp前体和元数据语义。
- 当课程内容块(标题、目标、讨论、活动、全体会议)出现在课程架构中时,会自动插入。
- 支持结合媒体、标注、演讲者笔记、自定义类和背景选项的幻灯片布局。
- 主题、大小、页眉/页脚和分页选项通过与Marp兼容的封面出现。
- 渲染助手,包裹Marp CLI,将Markdown导出为PPTX、PDF或HTML,其功能与手动导出相同。
- Markdown验证器,确保生成的输出在渲染前遵循Marp支持的语法。
安装
pip install -e .CLI期望 Marp命令行界面 (marp)可在您的 PATH.通过安装 npm install -g @marp-team/marp-cli 或贯穿 npx.
CLI使用情况
# Convert structured lesson data into Marp Markdown
mcp-marp parse examples/pshe.json -o build/pshe.marp.md
# Render an existing markdown file into PPTX, PDF, and HTML
mcp-marp render build/pshe.marp.md --format pptx --format pdf --format html
# Parse and immediately render
mcp-marp build examples/pshe.json --out build/pshe.marp.md --format pptx --format pdf跑 mcp-marp --help 以获取完整的命令参考。
发展
src/mcp_marp/parser.py包含主要内容LessonParser将结构化数据转换为Markdown的类。src/mcp_marp/validator.py在渲染之前添加语法验证层。src/mcp_marp/cli.py通过命令行公开解析和呈现操作。
涵盖不同Marp主题和教育场景的示例模板存储在 examples/.复制 src/mcp_marp/templates/lesson.css 在您生成的Markdown旁边(或从Marp前端引用它)启用自定义列布局。
