local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Converts Markdown documents to PDF files with support for syntax highlighting, custom styling, and optional watermarking. Handles standard Markdown elements including headers, lists, tables, code blocks, and images.
Uses Puppeteer and Chrome's rendering engine to generate high-quality PDFs from Markdown content with reliable resource loading and rendering of modern web features and fonts.

Servidor MCP de Markdown2PDF (markdown2pdf-mcp)

Un servidor MCP para convertir documentos Markdown a archivos PDF. Este servidor proporciona una forma sencilla y eficiente de generar PDF a partir de contenido Markdown, con resaltado de sintaxis y estilos personalizados. También permite añadir marcas de agua en la página 1.

Inspirado en el PDF de rebajas de Alan Shaw.

Características

Convierte Markdown a PDF con un solo comando
Resaltado de sintaxis para bloques de código
Estilo CSS personalizado para salida PDF
Compatibilidad con el formato Markdown estándar
Generación moderna de PDF mediante el motor de renderizado de Chrome
Excelente soporte para fuentes y funciones web modernas
Carga y renderizado de recursos confiables

Limitaciones

Los siguientes elementos de Markdown no son compatibles:

Ecuaciones matemáticas LaTeX (por ejemplo, $x^2$ o $$\sum_{i=1}^n x_i$$ )
Fórmulas matemáticas complejas o notación científica

Apéguese a estos elementos de rebajas admitidos:

Encabezados (todos los niveles)
Formato de texto (negrita, cursiva, tachado)
Listas (ordenadas y desordenadas)
Bloques de código con resaltado de sintaxis
Tablas
Citas en bloque
Campo de golf
Imágenes (tanto archivos locales como URL externas)
Listas de tareas

Instalación

# Clone the repository
git clone https://github.com/2b3pro/markdown2pdf-mcp.git

# Navigate to the project directory
cd markdown2pdf-mcp

# Install dependencies
npm install

# Build the project
npm run build

Uso

Iniciando el servidor

npm start

Uso de la herramienta MCP

El servidor proporciona una única herramienta create_pdf_from_markdown con los siguientes parámetros:

{
  // Required parameters
  markdown: string;    // Markdown content to convert

  // Optional parameters with defaults
  outputFilename?: string;  // Filename for the PDF (e.g., "output.pdf")
  paperFormat?: string;     // 'letter' (default), 'a4', 'a3', 'a5', 'legal', 'tabloid'
  paperOrientation?: string; // 'portrait' (default), 'landscape'
  paperBorder?: string;     // '2cm' (default), accepts decimal values with CSS units (e.g., '1.5cm', '2.5mm', '0.5in', '10.5px')
  watermark?: string;       // Optional watermark text (max 15 characters, uppercase)
}

Ejemplo con opciones:

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
    paperFormat: "a4",
    paperOrientation: "landscape",
    paperBorder: "1.5cm",
    watermark: "DRAFT",
  },
});

Ejemplo de uso mínimo:

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
  },
});

Configuración

Directorio de salida

Puedes configurar el directorio de salida en tu archivo de configuración de MCP para aplicaciones que usan MCP, como Cline o Claude. Si no se configura, se guardarán los archivos en $HOME:

{
  "mcpServers": {
    "markdown2pdf": {
      "command": "node",
      "args": ["path/to/markdown2pdf-mcp/build/index.js"],
      "env": {
        "M2P_OUTPUT_DIR": "/path/to/output/directory"
      }
    }
  }
}

La herramienta maneja automáticamente los conflictos de nombres de archivos agregando números incrementales (por ejemplo, salida.pdf, salida-1.pdf, salida-2.pdf).

Dependencias

@modelcontextprotocol/sdk - SDK de MCP para implementación de servidor
notable - Analizador de Markdown
highlight.js - Resaltado de sintaxis
Titiritero : Generación moderna de PDF con Chrome para pruebas (v131.0.6778.204)

Versión de Chrome

Este paquete usa Chrome v131.0.6778.204 para una generación de PDF consistente en todas las instalaciones. Esta versión se instala automáticamente al ejecutar npm install .

tmp - Manejo de archivos temporales

Desarrollo

# Build the project
npm run build

# Start the server
npm start

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

create_pdf_from_markdown

Un servidor MCP para convertir documentos Markdown en archivos PDF.