READMEmain

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

Download install_windows.bat from this repository
Right-click and select "Run as administrator"
Follow the on-screen instructions

macOS

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

Linux (Ubuntu/Debian)

Download install_linux.sh from this repository
Open Terminal and navigate to the download location
Run: chmod +x install_linux.sh && sudo ./install_linux.sh
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

Clone this repository

Build the server:

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

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):

// In the "servers" section
"pandoc_mcp_go": {
  "type": "stdio",
  "command": "C:/SnowWhiteAI/MCP_servers/mcp-pandoc-go/pandoc-mcp-go.exe",
  "cwd": "C:/SnowWhiteAI/MCP_servers/mcp-pandoc-go"
}

// In the "roots" section
"pandoc": {
  "type": "document-converter",
  "server": "pandoc_mcp_go"
}

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

Contributing

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

mcp-pandoc-go