mcp-pandoc
mcp-pandoc: un servidor MCP de conversión de documentos
Incluido oficialmente en el proyecto de código abierto de servidores de Protocolo de Contexto de Modelo . 🎉
Descripción general
Un servidor de Protocolo de Contexto de Modelo para la conversión de formatos de documentos mediante pandoc . Este servidor proporciona herramientas para transformar contenido entre diferentes formatos de documentos, conservando el formato y la estructura.
Tenga en cuenta que mcp-pandoc se encuentra actualmente en desarrollo inicial. La compatibilidad con PDF también está en desarrollo, y la funcionalidad y las herramientas disponibles están sujetas a cambios y ampliaciones a medida que mejoramos el servidor.
Crédito: Este proyecto utiliza el paquete Python Pandoc para la conversión de documentos, lo que constituye la base de este proyecto.
Related MCP server: md2pdf-mcp
Manifestación

Más por venir...
Herramientas
convert-contentsTransforma el contenido entre formatos compatibles
Entradas:
contents(cadena): contenido de origen a convertir (obligatorio si no se proporciona input_file)input_file(cadena): ruta completa al archivo de entrada (obligatorio si no se proporciona el contenido)input_format(cadena): formato de origen del contenido (predeterminado en Markdown)output_format(cadena): formato de destino (predeterminado en Markdown)output_file(cadena): ruta completa para el archivo de salida (obligatorio para los formatos pdf, docx, rst, latex, epub)
Formatos de entrada/salida admitidos:
reducción
html
pdf
docx
primero
látex
libro electrónico
TXT
Nota: Para formatos avanzados (pdf, docx, rst, latex, epub), se requiere una ruta de archivo de salida
Formatos compatibles
Formatos admitidos actualmente:
Formatos básicos (conversión directa):
Texto sin formato (.txt)
Markdown (.md)
HTML (.html)
Formatos avanzados (requiere rutas de archivo completas):
PDF (.pdf) - requiere instalación de TeX Live
DOCX (.docx)
RST (.rst)
LaTeX (.tex)
EPUB (.epub)
Nota: Para formatos avanzados:
Se requieren rutas de archivo completas con nombre de archivo y extensión
La conversión de PDF requiere la instalación de TeX Live (consulte la sección Requisitos críticos -> Para macOS:
brew install texlive)Cuando no se especifica ninguna ruta de salida:
Formatos básicos: Muestra el contenido convertido en el chat.
Formatos avanzados: Se puede guardar en el directorio temporal del sistema (/tmp/ en sistemas Unix)
Uso y configuración
Para utilizar el publicado
{
"mcpServers": {
"mcp-pandoc": {
"command": "uvx",
"args": ["mcp-pandoc"]
}
}
}⚠️ Notas importantes
Requisitos críticos
Requisitos previos para la conversión de PDF
TeX Live debe estar instalado antes de intentar la conversión a PDF
Comandos de instalación:
# Ubuntu/Debian sudo apt-get install texlive-xetex # macOS brew install texlive # Windows # Install MiKTeX or TeX Live from: # https://miktex.org/ or https://tug.org/texlive/
Requisitos de ruta de archivo
Al guardar o convertir archivos, DEBE proporcionar las rutas de archivo completas, incluido el nombre del archivo y la extensión.
La herramienta no genera automáticamente nombres de archivos ni extensiones.
Ejemplos
✅ Uso correcto:
# Converting content to PDF
"Convert this text to PDF and save as /path/to/document.pdf"
# Converting between file formats
"Convert /path/to/input.md to PDF and save as /path/to/output.pdf"❌ Uso incorrecto:
# Missing filename and extension
"Save this as PDF in /documents/"
# Missing complete path
"Convert this to PDF"
# Missing extension
"Save as /documents/story"Problemas comunes y soluciones
La conversión de PDF falla
Error: "xelatex no encontrado"
Solución: Instale primero TeX Live (consulte los comandos de instalación anteriores)
La conversión de archivos falla
Error: "Ruta de archivo no válida"
Solución: proporcione la ruta completa, incluido el nombre del archivo y la extensión
Ejemplo:
/path/to/document.pdfen lugar de simplemente/path/to/
La conversión de formato falla
Error: "Formato no compatible"
Solución: utilice únicamente formatos compatibles:
Básico: txt, html, markdown
Avanzado: pdf, docx, rst, latex, epub
Inicio rápido
Instalar
Opción 1: Instalación manual mediante el archivo de configuración claude_desktop_config.json
En MacOS:
open ~/Library/Application\ Support/Claude/claude_desktop_config.jsonEn Windows:
%APPDATA%/Claude/claude_desktop_config.json
ℹ️ Reemplace con la ruta de su proyecto clonado localmente
"mcpServers": {
"mcp-pandoc": {
"command": "uv",
"args": [
"--directory",
"<DIRECTORY>/mcp-pandoc",
"run",
"mcp-pandoc"
]
}
}"mcpServers": {
"mcp-pandoc": {
"command": "uvx",
"args": [
"mcp-pandoc"
]
}
}Opción 2: Instalar automáticamente la configuración de servidores publicados a través de Smithery
Ejecute el siguiente comando bash para instalar automáticamente mcp-pandoc pypi publicado para Claude Desktop a través de Smithery :
npx -y @smithery/cli install mcp-pandoc --client claudeNota : Para utilizar mcp-pandoc configurado localmente, siga el paso "Configuración de servidores no publicados/desarrollo" anterior.
Desarrollo
Construcción y publicación
Para preparar el paquete para su distribución:
Sincronizar dependencias y actualizar archivo de bloqueo:
uv syncDistribuciones de paquetes de compilación:
uv buildEsto creará distribuciones de origen y de rueda en el directorio dist/ .
Publicar en PyPI:
uv publishNota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:
Token:
--tokenoUV_PUBLISH_TOKENO nombre de usuario/contraseña:
--username/UV_PUBLISH_USERNAMEy--password/UV_PUBLISH_PASSWORD
Depuración
Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .
Puede iniciar el Inspector MCP a través de npm con este comando:
npx @modelcontextprotocol/inspector uv --directory /Users/vivekvells/Desktop/code/ai/mcp-pandoc run mcp-pandocAl iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.
Contribuyendo
Agradecemos sus contribuciones para mejorar mcp-pandoc. Así es como puede participar:
Reportar problemas : ¿Encontraste un error o tienes alguna solicitud de funcionalidad? Abre un problema en nuestra página de problemas de GitHub .
Enviar solicitudes de extracción : mejore la base de código o agregue funciones mediante la creación de una solicitud de extracción.
Available Tools
1 toolconvert-contentsA
Converts content between different formats. Transforms input content from any supported format into the specified output format.
🚨 CRITICAL REQUIREMENTS - PLEASE READ:
PDF Conversion:
You MUST install TeX Live BEFORE attempting PDF conversion:
Ubuntu/Debian:
sudo apt-get install texlive-xetexmacOS:
brew install texliveWindows: Install MiKTeX or TeX Live from https://miktex.org/ or https://tug.org/texlive/
PDF conversion will FAIL without this installation
File Paths - EXPLICIT REQUIREMENTS:
When asked to save or convert to a file, you MUST provide:
Complete directory path
Filename
File extension
Example request: 'Write a story and save as PDF'
You MUST specify: '/path/to/story.pdf' or 'C:\Documents\story.pdf'
The tool will NOT automatically generate filenames or extensions
File Location After Conversion:
After successful conversion, the tool will display the exact path where the file is saved
Look for message: 'Content successfully converted and saved to: [file_path]'
You can find your converted file at the specified location
If no path is specified, files may be saved in system temp directory (/tmp/ on Unix systems)
For better control, always provide explicit output file paths
Supported formats:
Basic (returned inline): txt, html, markdown, ipynb
Advanced (REQUIRE complete file paths): pdf, docx, rst, latex, epub, odt, pptx
pptx is WRITE-ONLY: it can be produced, but not used as an input format ✅ CORRECT Usage Examples:
'Convert this text to HTML' (basic conversion)
Tool will show converted content
'Save this text as PDF at /documents/story.pdf'
Correct: specifies path + filename + extension
Tool will show: 'Content successfully converted and saved to: /documents/story.pdf'
❌ INCORRECT Usage Examples:
'Save this as PDF in /documents/'
Missing filename and extension
'Convert to PDF'
Missing complete file path
When requesting conversion, ALWAYS specify:
The content or input file
The desired output format
For advanced formats: complete output path + filename + extension Example: 'Convert this markdown to PDF and save as /path/to/output.pdf'
🎨 DOCX, ODT & PPTX STYLING: 4. Custom Styling with Reference Documents:
Use reference_doc parameter to apply professional styling to DOCX, ODT and PPTX output
The reference document MUST match the output format: .docx for docx, .odt for odt, .pptx for pptx
Create custom templates with your branding, fonts, and formatting
Perfect for corporate reports, academic papers, and professional documents
Example: 'Convert this report to DOCX using /templates/corporate-style.docx as reference and save as /reports/Q4-report.docx'
🎯 PANDOC FILTERS (NEW FEATURE): 5. Pandoc Filter Support:
Use filters parameter to apply custom Pandoc filters during conversion
Filters are Python scripts that modify document content during processing
Perfect for Mermaid diagram conversion, custom styling, and content transformation
Example: 'Convert this markdown with mermaid diagrams to DOCX using filters=["./filters/mermaid-to-png-vibrant.py"] and save as /reports/diagram-report.docx'
📋 Creating Reference Documents:
Generate template: pandoc -o template.docx --print-default-data-file reference.docx
Customize in Word/LibreOffice: fonts, colors, headers, margins
Use for consistent branding across all documents
📋 Filter Requirements:
Filters must be executable Python scripts
Use absolute paths or paths relative to current working directory
Filters are applied in the order specified
Common filters: mermaid conversion, color processing, table formatting
📄 Defaults File Support (NEW FEATURE): 7. Pandoc Defaults File Support:
Use defaults_file parameter to specify a YAML configuration file
Similar to using pandoc -d option in the command line
Allows setting multiple options in a single file
Options in the defaults file can include filters, reference-doc, and other Pandoc options
Example: 'Convert this markdown to DOCX using defaults_file="/path/to/defaults.yaml" and save as /reports/report.docx'
Note: After conversion, always check the success message for the exact file location.
Inputs: filters, contents, input_file, output_file, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of an agent mistaking it for another. Its purpose is clearly defined as content conversion, with no overlapping tools.
Although there is only one tool, the name 'convert-contents' follows a clear verb_noun convention and is semantically appropriate. With no other tools, there are no naming conflicts or mixed conventions.
A single tool for Pandoc conversion feels minimal, though it can cover many conversions through its parameters. It is on the thin side of the acceptable range for a focused converter server.
The tool supports conversion across a wide range of formats, including inline returns and file outputs, plus advanced options like reference documents, filters, and defaults files. For a conversion-only server, this covers the domain thoroughly with no obvious operational gaps.
Maintenance
Related MCP Connectors
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Generate PDF, Word (.docx) and PowerPoint (.pptx) documents from Markdown over MCP.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Related MCP Servers
- AlicenseBqualityDmaintenanceA universal MCP server for document processing, conversion, and automation. Handle PDF, DOCX, HTML, Markdown, and more through a unified API and toolset.1328 npm140MIT
- MIT
- AlicenseAqualityDmaintenanceA secure MCP server for converting documents between Markdown, DOCX, HTML, PDF, and TXT formats within a sandboxed working directory.3MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for converting between document formats (DOCX/PDF to Markdown and Markdown to DOCX) with academic styling support.24 PyPI1MIT