Overview: mcp-pandoc - A Document Conversion MCP Server

Title

mcp-pandoc: A Document Conversion MCP Server

How to Use

mcp-pandoc is a Model Context Protocol (MCP) server designed for seamless document format conversion using pandoc. It supports transformations between various formats while preserving structure and formatting.

Installation

1. Published Server (Recommended)

   npx -y @smithery/cli install mcp-pandoc --client claude  

   Or manually configure via claude_desktop_config.json.

2. Local Development
   Clone the repository and set up the server using:

   uv sync  
   uv build  

Critical Requirements

• PDF Conversion: Requires TeX Live (brew install texlive on macOS).
• File Paths: Must include full paths with extensions (e.g., /path/to/output.pdf).

Key Features

• Multi-Format Conversion:
  • Basic Formats: Markdown, HTML, plain text (direct chat output).
  • Advanced Formats: PDF, DOCX, LaTeX, EPUB (requires file paths).
• Tool Integration:
  • convert-contents: Transforms content between supported formats.
• Cross-Platform: Works on macOS, Windows, and Linux.

Use Cases

1. Document Conversion: Convert Markdown to PDF, HTML to DOCX, etc.
2. Content Preservation: Maintain formatting during format transitions.
3. Automation: Integrate with workflows requiring batch conversions.

Example Commands

✅ Correct:

"Convert /path/to/input.md to PDF and save as /path/to/output.pdf"  

❌ Incorrect:

"Save this as PDF in /documents/"  # Missing filename/extension  

For more details, refer to the GitHub repository or watch the demo video.

---

Note: mcp-pandoc is in active development; features may evolve. Contributions are welcome!