How do I install the MarceauSolutions/md-to-pdf-mcp MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "md-to-pdf-mcp": { "command": "npx", "args": ["-y", "MarceauSolutions/md-to-pdf-mcp"] } }

What does MarceauSolutions/md-to-pdf-mcp do?

🐍 🏠 🍎 🪟 🐧 - Convert Markdown files to professional PDFs with customizable themes, headers, footers, and styling

Quick Install

One-Click IDE Configuration

claude_desktop_config.json

{
  "mcpServers": {
    "marceausolutions-md-to-pdf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "marceausolutions-md-to-pdf-mcp"
      ]
    }
  }
}

Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.

Documentation Overview

Markdown to PDF Converter

Convert markdown (.md) files into professional, interactive PDF documents with automatic table of contents.

mcp-name: io.github.wmarceau/md-to-pdf

Features

Automatic Table of Contents - Generated from markdown headers
Interactive Navigation - Clickable TOC links to sections
Professional Styling - Clean, readable PDF output
Code Block Support - Syntax highlighting preserved
Table Support - Markdown tables convert to PDF tables
Image Support - Embedded images in PDFs
Batch Conversion - Process multiple files at once
MCP Integration - Use as an MCP server for AI assistants

Use Cases

Convert documentation to shareable PDFs
Create professional reports from markdown
Generate user manuals with navigation
Archive markdown content in PDF format
Prepare presentations or handouts
AI-powered document generation workflows

Project Structure

md-to-pdf/
├── src/
│   ├── md_to_pdf.py          # Core conversion logic
│   └── convert.sh            # Wrapper script (sets library paths)
├── mcp-server/
│   └── md_to_pdf_mcp.py      # MCP server wrapper
├── registry/
│   └── manifest.json         # MCP Registry manifest
├── workflows/
│   └── convert-md-to-pdf.md  # Conversion workflow guide
├── testing/                  # Multi-agent test infrastructure
├── VERSION                   # Current version
├── CHANGELOG.md              # Version history
├── SKILL.md                  # MCP skill documentation
└── README.md                 # This file

Requirements

Python 3.8+
markdown2 (markdown parsing)
weasyprint (PDF generation)
pygments (code syntax highlighting)
mcp (MCP server - for MCP mode only)

macOS Additional Requirements

brew install pango cairo

Quick Start

CLI Usage

# Set library path (macOS)
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH

# Convert single file
python src/md_to_pdf.py input.md output.pdf

# Using wrapper script
./src/convert.sh input.md output.pdf

# Batch convert
python src/md_to_pdf.py "docs/*.md" --output-dir pdfs/

# With custom styling
python src/md_to_pdf.py input.md output.pdf --css custom.css

# Without table of contents
python src/md_to_pdf.py input.md output.pdf --no-toc

MCP Server Usage

# Install MCP SDK
pip install mcp

# Run MCP server
python mcp-server/md_to_pdf_mcp.py

MCP Tools

Tool	Description
`convert_markdown_to_pdf`	Convert markdown to PDF with optional TOC
`extract_toc`	Extract table of contents structure
`get_default_styles`	Get default CSS for customization

See SKILL.md for detailed MCP tool documentation.

Version

Current version: 1.0.0

License

MIT License

Md To Pdf Mcp