What is Mcp Pandoc Go

mcp-pandoc-go is a document conversion server designed for Cursor IDE, utilizing the Pandoc conversion engine to facilitate the transformation of documents between various formats such as markdown, HTML, PDF, and more.

Use cases

Use cases for mcp-pandoc-go include converting markdown files to Word documents, generating PDFs from HTML content, creating professional documents directly from markdown in Cursor IDE, and ensuring consistent branding across all generated documents.

How to use

To use mcp-pandoc-go, install it using the provided scripts for your operating system (Windows, macOS, or Linux). After installation, you can convert documents by making API calls through the Cursor MCP API, specifying the desired input and output formats.

Key features

Key features include fast document conversion, support for multiple formats (markdown, HTML, PDF, DOCX, RST, LaTeX, EPUB, TXT), automatic path normalization for Windows, multiple conversion modes (string-to-string, string-to-file, file-to-file), and automatic copyright addition to generated documents.

Where to use

mcp-pandoc-go is suitable for use in various fields including software development, content creation, academic publishing, and any scenario where document format conversion is required.

MCP-Pandoc

A simple and powerful document conversion server for Cursor IDE using Pandoc.

When to use this

✅ When you need to convert documents between different formats
Converting markdown to Word, HTML to PDF, or any combination of supported formats.

✅ When you want to generate professional documents in Cursor
Creating Word documents, PDFs, or other formats directly from your markdown content.

✅ When you need consistent document branding
Automatically adds copyright and branding to all generated documents.

✅ When you need a reliable, high-quality document converter
Built on the industry-standard Pandoc conversion engine.

Features

• Fast document conversion through the Cursor MCP API
• Supports markdown, HTML, PDF, DOCX, RST, LaTeX, EPUB, TXT
• Automatic path normalization for Windows compatibility
• Multiple conversion modes: string-to-string, string-to-file, file-to-file
• Automatic copyright addition to all generated documents

Quick Installation

We provide automated installation scripts for all major operating systems:

Windows

1. Download install_windows.bat from this repository
2. Right-click and select “Run as administrator”
3. Follow the on-screen instructions

macOS

1. Download install_macos.sh from this repository
2. Open Terminal and navigate to the download location
3. Run: chmod +x install_macos.sh && sudo ./install_macos.sh
4. Follow the on-screen instructions

Linux (Ubuntu/Debian)

1. Download install_linux.sh from this repository
2. Open Terminal and navigate to the download location
3. Run: chmod +x install_linux.sh && sudo ./install_linux.sh
4. Follow the on-screen instructions

The installation scripts will:

• Check for required dependencies
• Create the necessary directories
• Clone the repository
• Build the application
• Configure Cursor IDE

Manual Installation

Prerequisites

• Pandoc must be installed and available in your PATH
  • Download and install manually from the official website
  • Important: Restart your computer after installing Pandoc
  • You can verify installation by running pandoc --version in terminal
• For PDF generation, a LaTeX distribution is required (MiKTeX recommended for Windows)
• Git and Go programming language must be installed

Manual Build

1. Clone this repository
2. Build the server:

   go build -o pandoc-server.exe ./cmd/main.go
   

3. Run the server:

   ./pandoc-server.exe
   

Integration with Cursor IDE

To integrate with Cursor IDE, add the following to your MCP configuration file (mcp.json):

Usage Examples

Convert markdown to HTML

result, err := converter.ConvertString("# Hello World", "markdown", "html")

Convert markdown to Word document

err := converter.ConvertStringToFile("# Hello World", "markdown", "docx", "output.docx")

Convert existing file to PDF

err := converter.ConvertFile("input.md", "markdown", "pdf", "output.pdf")

Example Scripts

Check the examples directory for sample files and scripts:

• sample.md - Sample markdown document for testing
• convert_example.ps1 - PowerShell script demonstrating how to use the server

License

© 2025 SnowWhite AI - All Rights Reserved

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.