MCP MD2PDF Server

Espone un server MCP con strumenti avanzati per:

- Integrazione con client MCP
- API programmatica per conversioni
- Gestione avanzata di contenuti e metadati
- Controllo granulare delle opzioni di conversione

- Conversione Markdown → PDF di alta qualità
- Supporto completo per diagrammi Mermaid
- Personalizzazione dell'output (formato carta, stili, indice)
- Gestione degli stili di syntax highlighting
- Rendering professionale con LaTeX

- Python 3.7+con pip
- Docker(per l'ambiente di conversione)
- Sistema operativo: Linux, macOS, Windows (con WSL)

Esegui lo script di installazione che configura tutto automaticamente:
- ✅ Verifica Python e pip
- 📦 Installa le dipendenze Python
- � Verifica Docker
- 🏗️ Costruisce l'immagine Docker per Pandoc/Mermaid
- 🧪 Esegue test di funzionalità
- 🚀 Crea script di avvio
- 📝 Crea file di test

Utilizzare direttamente lo script di conversione:

# Conversione semplice ./convert.sh input.md output.pdf # Conversione con file di esempio ./convert.sh test_document.md test_document.pdf

- ⚡ Veloce e immediato
- 🚀 Nessuna configurazione server
- 📝 Perfetto per script automatizzati
- 🔄 Ideale per CI/CD pipeline

Il server si connette tramite stdio. Esempio di configurazione:

{ "mcpServers": { "md2pdf": { "command": "python3", "args": ["/path/to/mcp_md2pdf_server.py"], "cwd": "/workspace/db-ready/md2pdf/" } } }

- 🔌 Integrazione con client MCP
- 📊 API strutturata con response JSON
- 🎯 Controllo granulare dei parametri
- 📦 Gestione avanzata di contenuti e metadati

- ⚡ Hai bisogno di conversioni rapide e immediate
- 🔄 Stai automatizzando processi in script bash/shell
- 🏗️ Integri in pipeline CI/CD
- � Converti documenti occasionalmente
- 🖥️ Lavori principalmente da command line
- ⚙️ Vuoi il minimo overhead di setup

# Nel tuo script di build ./convert.sh documentation.md docs/manual.pdf

- 🔌 Ti integri con client MCP esistenti
- 📊 Hai bisogno di response strutturate JSON
- 🎛️ Vuoi controllo granulare sui parametri
- 📦 Gestisci metadati complessi (title, author, etc.)
- 🔄 Converti contenuti dinamici da applicazioni
- 🖥️ Sviluppi applicazioni che richiedono API

# Nel tuo client MCP result = await mcp_client.call_tool("convert_md_to_pdf", { "markdown_content": dynamic_content, "title": "Report Generato", "author": "Sistema Automatico" })

Il server MCP espone i seguenti strumenti:

{ "success": true, "filename": "output.pdf", "size_bytes": 123456, "size_human": "120.6 KB", "pdf_base64": "JVBERi0xLjQK...", "message": "✅ PDF generato con successo" }

Converte un file Markdown esistente in PDF.

{ "success": true, "output_path": "/path/to/output.pdf", "filename": "output.pdf", "size_bytes": 123456, "size_human": "120.6 KB", "message": "✅ PDF salvato in: /path/to/output.pdf" }

Elenca gli stili di syntax highlighting disponibili.

{ "success": true, "styles": ["pygments", "kate", "monochrome", "breezeDark", ...], "count": 25 }

Ottiene informazioni sulla versione di Pandoc e funzionalità disponibili.

{ "success": true, "pandoc_version": "pandoc 3.1.11", "pdf_engines": ["pdflatex", "xelatex", "lualatex"], "mermaid_filter_available": true }

# Conversione base ./convert.sh document.md document.pdf # Conversione con file di documentazione ./convert.sh README.md manual.pdf # Batch conversion (esempio script) for file in *.md; do ./convert.sh "$file" "${file%.md}.pdf" done # Integrazione in Makefile docs: ./convert.sh docs/api.md dist/api-manual.pdf ./convert.sh docs/guide.md dist/user-guide.pdf

import asyncio from mcp_md2pdf_server import convert_md_to_pdf async def generate_report(): content = f""" # Report Giornaliero Data: {datetime.now().strftime('%Y-%m-%d')} ## Statistiche - Utenti attivi: {get_active_users()} - Vendite: {get_sales_data()} """ result = await convert_md_to_pdf( markdown_content=content, output_filename="daily_report.pdf", title="Report Giornaliero", author="Sistema Automatico" ) return result

{ "tool": "convert_md_file_to_pdf", "arguments": { "input_path": "/docs/specification.md", "output_path": "/output/spec_v2.pdf", "title": "API Specification v2.0", "author": "Development Team", "papersize": "a4", "toc": true } }

Il server supporta completamente i diagrammi Mermaid. Esempi di diagrammi supportati:

graph TD A[Start] --> B{Decision} B -->|Yes| C[Action 1] B -->|No| D[Action 2] C --> E[End] D --> E

sequenceDiagram participant A as Alice participant B as Bob A->>B: Hello Bob, how are you? B-->>A: Great!

gantt title A Gantt Diagram dateFormat YYYY-MM-DD section Section A task :a1, 2014-01-01, 30d Another task :after a1 , 20d

md2pdf/ ├── mcp_md2pdf_server.py # Server MCP principale ├── requirements.txt # Dipendenze Python ├── Dockerfile # Immagine Docker per conversione ├── convert.sh # Script di conversione ├── pandoc-wrapper.sh # Wrapper per Pandoc ├── install.sh # Script di installazione ├── start_server.sh # Script di avvio (generato) ├── test_document.md # Documento di test (generato) └── README.md # Questa documentazione

- Ubuntu 22.04come base
- Pandoc 3.1.11per la conversione
- Node.js 18.xper mermaid-filter
- TeX Liveper la generazione PDF
- Google Chromeper il rendering Mermaid
- mermaid-filtere@mermaid-js/mermaid-cli

- Formati carta: a4, letter, a3, legal, etc.
- Stili highlighting: pygments, kate, monochrome, breezeDark, etc.
- Engines PDF: pdflatex, xelatex, lualatex
- Opzioni layout: margini personalizzabili, indice, numerazione pagine

Errore: Docker daemon non in esecuzione Soluzione: Avvia Docker Desktop o il daemon Docker

Errore: Unable to find image 'pandoc-mermaid:latest' Soluzione: Ricostruisci l'immagine con: docker build -t pandoc-mermaid .

Errore: mermaid-filter non trovato Soluzione: Ricostruisci l'immagine Docker per installare mermaid-filter

Errore: Permission denied Soluzione: Verifica i permessi dei file e directory

Il server MCP scrive su stdout/stderr. Per salvare i log:

python3 mcp_md2pdf_server.py 2>&1 | tee server.log

# Test con documento di esempio ./convert.sh test_document.md test_output.pdf # Test con contenuto personalizzato echo "# Test Document" > my_test.md ./convert.sh my_test.md my_test.pdf

./convert.sh mermaid_test.md mermaid_test.pdf