aigroup-mdtopptx-mcp

aigroup-mdtopptx-mcp is a standalone MCP server that turns Markdown into banker-style, editable .pptx decks.

Goals

• accept Markdown content or a Markdown file
• produce a real editable PowerPoint, not flattened screenshots
• give large models a stable Markdown-first route for deck generation
• keep layout conventions close to investment-banking style decks

Multi-Step Tooling

This server is designed so a large model can work in stages instead of jumping straight from Markdown to slides.

• analyze_markdown_report
  • inspect Markdown structure
  • count sections, bullets, tables
  • recommend full_report or executive_deck
• build_pptx_outline
  • convert the report into a slide plan before rendering
  • useful when the model needs to reason about deck flow first
• markdown_to_pptx
  • render the actual editable PowerPoint
• verify_pptx_editable
  • verify the generated PPTX still contains editable text/table objects

Render Modes

• full_report
  • preserve report completeness
  • suitable for long-form analysis decks
• executive_deck
  • compress sections into a smaller management-summary deck

Typical LLM Workflow

1. Run analyze_markdown_report
2. Inspect recommended_mode
3. Run build_pptx_outline
4. Optionally refine the deck plan in-model
5. Run markdown_to_pptx
6. Run verify_pptx_editable

Inputs:

• markdown or input_path
• optional output_path
• optional title, subtitle, company_name, author, report_date
• optional density: compact, balanced, spacious
• optional mode: full_report, executive_deck

Outputs:

• generated .pptx path
• title
• slide count
• section count

Local Development

npm install
npm run smoke
node ./scripts/verify-editable-pptx.mjs ./tmp/sample-report-smoke.pptx

Notes

• The renderer uses pptxgenjs, so text and tables remain editable in PowerPoint / Keynote.
• The default balanced density is meant to reduce slide sprawl on long Markdown reports.