Marp MCP Server

A Model Context Protocol (MCP) server for managing Marp presentation projects with academic theme support. Optimized for use with Claude Code, Cursor, and other AI-powered editors.

Features

• 🎨 Academic Theme Support - Pre-configured academic_custom.css theme

• 📁 Project Initialization - Automatic directory structure setup

• 🎯 Structured Slide Generation - 6 layout templates for consistent design

• 🔧 Editor Integration - Designed for Claude Code and Cursor

• 📝 Markdown Output - Generate slides as markdown strings for easy editing

Installation

Via npx (Recommended)

Global Installation

Local Installation

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

Or with global installation:

Claude Code / Cursor

The server works seamlessly with Claude Code and Cursor. The generated markdown can be directly inserted into your editor.

Available Tools

1. init_presentation

Initialize a new Marp presentation project with complete directory structure.

Parameters:

• projectPath (string) - Directory where project will be created

• projectName (string) - Name of the presentation project

• presentationTitle (string) - Title of the presentation

• presentationSubtitle (string, optional) - Subtitle

• description (string, optional) - Brief description

Generated Structure:

Example:

2. generate_slide

Generate a slide using academic theme layouts. Returns markdown string for copy-paste.

Parameters:

• layoutType (string) - Layout type (title, lead, content, table, multi-column, quote)

• params (object) - Layout-specific parameters

Example:

3. list_slide_layouts

List all available slide layouts with their parameters and descriptions.

No parameters required.

Available Layouts

Title Slide (title)

Centered title and subtitle with .title class.

Parameters:

• title (required, max 60 chars)

• subtitle (optional, max 100 chars)

Output:

Lead Slide (lead)

Left-aligned with maroon color headings using .lead class.

Parameters:

• heading (required, max 80 chars)

• content (optional, markdown supported)

Output:

Content Slide (content)

Standard content slide with optional heading.

Parameters:

• heading (optional, max 80 chars)

• content (required, markdown supported)

Output:

Table Slide (table)

Table with customizable size and alignment.

Parameters:

• heading (optional, max 80 chars)

• tableMarkdown (required, markdown table)

• tableClass (optional: "center", "100", "tiny", "small", "large")

Output:

Multi-Column Slide (multi-column)

2-3 column layout using double blockquote syntax.

Parameters:

• heading (optional, max 80 chars)

• columns (required, array of strings)

Output:

Quote Slide (quote)

Quote with citation in footer.

Parameters:

• heading (optional, max 80 chars)

• content (optional)

• quote (required, max 300 chars)

• citation (optional, max 100 chars)

Output:

Academic Theme Features

The included academic_custom.css theme provides:

• Page numbering - Automatic slide numbers

• Custom fonts - Noto Sans JP and Source Code Pro

• Color scheme - Maroon highlights (#800000)

• Table styles - Multiple size and alignment options

• Multi-column support - Flexible column layouts

• Header support - Customizable presentation headers

CSS Classes

• .title - Title slide (centered)

• .lead - Lead slide (left-aligned, maroon)

• .table-center - Centered table

• .table-100 - Full-width table

• .table-tiny - Small font table (0.7em)

• .table-small - Small font table (0.8em)

• .table-large - Large font table (1.1em)

Building Presentations

Prerequisites

Install Marp CLI:

Build to PDF

Build to HTML

Build to PowerPoint

Preview in VS Code

Install Marp for VS Code extension for live preview.

Development

Building from Source

Testing Locally

Then configure Claude Desktop to use the local version.

Troubleshooting

Server Not Starting

Check logs in ~/Library/Logs/Claude/:

Template Files Not Found

Ensure the package was built correctly:

Should show:

• academic_custom.css

• slides.template.md

• README.template.md

• gitignore.template

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

Credits

• Academic theme based on marp-theme-academic by kaisugi

• Built on Model Context Protocol

• Powered by Marp

Links

• GitHub Repository

• npm Package

• Marp Documentation

• MCP Documentation