MCP Md Mmd Pdf

🚀 Markdown + Mermaid to PDF MCP Server

An MCP (Model Context Protocol) server that transforms Markdown files with Mermaid diagrams into PDF documents. It can also convert standalone Mermaid diagrams to PNG or PDF. The server employs a hybrid method: converting Markdown to HTML, rendering Mermaid diagrams as SVG graphics, and then using Puppeteer to generate outputs.

🚀 Quick Start

This server can convert Markdown files with Mermaid diagrams to PDF, and standalone Mermaid diagrams to PNG or PDF. Check the following sections for installation and usage details.

✨ Features

• Convert Markdown files with Mermaid diagrams to PDF.
• Convert standalone Mermaid diagram code to PNG images.
• Convert standalone Mermaid diagram code to PDF files.
• Automatically render Mermaid diagrams as high - quality SVG graphics.
• Provide clean and professional default styling.
• Support custom CSS styling (for Markdown conversion).
• Offer a simple MCP tool interface.

📦 Installation

npm install
npm run build

💻 Usage Examples

As an MCP Server

Add this server to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "md-mmd-pdf": {
      "command": "node",
      "args": ["/absolute/path/to/md-mmd-pdf/build/index.js"]
    }
  }
}

Tool: convert_md_to_pdf

Converts a Markdown file with Mermaid diagrams to PDF.

Parameters:

• input_path (required): Absolute path to the input Markdown file.
• output_path (optional): Absolute path where the PDF should be saved. If not provided, uses the same name as input with .pdf extension.
• custom_css (optional): Additional CSS styles to apply to the PDF.

Example:

{
  "input_path": "/path/to/document.md",
  "output_path": "/path/to/output.pdf"
}

Tool: convert_mermaid_to_png

Converts a standalone Mermaid diagram code to a PNG image file.

Parameters:

• mermaid_code (required): Raw Mermaid diagram code as a string.
• output_path (required): Absolute path where the PNG file should be saved.

Example:

{
  "mermaid_code": "graph TD\n  A[Start] --> B[Process]\n  B --> C[End]",
  "output_path": "/path/to/diagram.png"
}

Tool: convert_mermaid_to_pdf

Converts a standalone Mermaid diagram code to a PDF file.

Parameters:

• mermaid_code (required): Raw Mermaid diagram code as a string.
• output_path (required): Absolute path where the PDF file should be saved.

Example:

{
  "mermaid_code": "sequenceDiagram\n  Alice->>Bob: Hello\n  Bob->>Alice: Hi!",
  "output_path": "/path/to/diagram.pdf"
}

📚 Documentation

How It Works

1. Markdown Parsing: Reads and parses Markdown content using the marked library.
2. HTML Generation: Converts Markdown to HTML while preserving Mermaid code blocks.
3. Mermaid Rendering: Injects Mermaid.js library to render diagrams as SVG in the browser.
4. PDF Export: Uses Puppeteer (headless Chrome) to generate the final PDF with all content rendered.

Example Markdown

See example.md for a sample document with Mermaid diagrams.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Run the server
npm start

Requirements

• Node.js 18 or higher.
• Sufficient memory for Puppeteer to run headless Chrome.

📄 License

MIT