AI导哈

模块化内容展示框架

MCP Marp框架是一个基于Marp渲染引擎的模块化内容展示工具，支持将JSON或YAML格式的结构化课程数据转换为功能齐全的Marp Markdown，适用于教育内容展示和自动化文档生成。

  • by gavanduffy
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 gavanduffy/marp-mcp

使用说明

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前端引用它）启用自定义列布局。

相关 MCP