MCP PDF Server

An MCP (Model Context Protocol) server exposing tools to render Markdown into PDF.

What’s included

• MCP tools: pdf_from_markdown (primary) and md_to_pdf (alias).

• Accepts inline Markdown or a file path.

• Options for paper format and orientation; sensible output/ defaults.

Prerequisites

• Node.js 18+ recommended.

Install

Build

Run (stdio)

Configure in your MCP-compatible client by pointing to the compiled binary or npm start command.

MCP Tools

• Tool ids: pdf_from_markdown (primary) and md_to_pdf (alias for discoverability)

  • Purpose: Generate a PDF from Markdown.

  • Inputs:

    • markdown (string, optional): Inline Markdown content. If set, path is ignored.

    • path (string, optional): Absolute or relative path to a .md file. Ignored if markdown is provided.

    • outputPath (string, optional): Desired output PDF path. Defaults to output/<timestamp>.pdf and creates missing directories.

    • paperFormat (string, optional): A4 | Letter | Legal (default: A4).

    • paperOrientation (string, optional): portrait | landscape (default: portrait).

    • Provide exactly one of markdown or path. If both are set, markdown takes precedence.

  • Output:

    • Returns a text message containing the absolute path to the created PDF.

  • Example (inline):

    { "tool": "md_to_pdf", "arguments": { "markdown": "# Hello\nThis will render to PDF.", "paperFormat": "A4" } }

  • Example (file path):

    { "tool": "pdf_from_markdown", "arguments": { "path": "examples/sample.md", "outputPath": "output/sample.pdf", "paperOrientation": "landscape" } }

Tool Schema (compact)

Client configuration (example) If your MCP client supports JSON configuration for a stdio server, a minimal entry might look like:

Notes

• Uses Playwright (Chromium) to render HTML from Markdown and print to PDF.

• On first install, Playwright may download a browser. You can also point it to an existing Chrome/Chromium.

One‑liner with npx

• After this package is published to npm, you can run the server directly:

  • npx -y md-2-pdf-mcp (runs the md-2-pdf-mcp bin)

  • Or explicitly: npx -y -p md-2-pdf-mcp mcp-pdf

  • The package defines bin entries and a postinstall that installs Chromium.

• From the local repo (without publishing):

  • npx --yes .

  • This uses the bin in package.json and the prepare script to build.