mcp-pandoc

📋 Overview:

This webpage is the GitHub repository for `mcp-pandoc`, an MCP (Model Context Protocol) server designed for document format conversion using Pandoc. It provides tools to transform content between different document formats while preserving formatting and structure. The project is officially included in the Model Context Protocol servers open-source project.

⭐ Key Points:
* `mcp-pandoc` is a document conversion server using Pandoc.
* It supports multiple document formats for conversion.
* PDF conversion requires TeX Live installation.
* Correct usage involves providing complete file paths including filename and extension for advanced formats.

* The project is under early development, with features subject to change.

🔍 Main Findings:
* The server provides a `convert-contents` tool to transform content between supported formats.
* Supported formats include markdown, html, pdf, docx, rst, latex, and epub.
* The repository offers instructions for manual installation or automatic installation via Smithery.
* The server uses uv for package management and build tools.

* The project welcomes contributions and provides guidelines for reporting issues and submitting pull requests.

📊 Details:
* Tool: `convert-contents` (transforms content)
* Inputs: `contents`, `inputfile`, `inputformat`, `outputformat`, `outputfile`
* Formats: markdown, html, pdf, docx, rst, latex, epub, txt
* Installation:
* Manual: via claudedesktopconfig.json
* MacOS: `open ~/Library/Application\ Support/Claude/claudedesktopconfig.json`
* Windows: `%APPDATA%/Claude/claudedesktopconfig.json`
* Automatic: via Smithery (`npx -y @smithery/cli install mcp-pandoc --client claude`)
* TeX Live Installation Commands:
* Ubuntu/Debian: `sudo apt-get install texlive-xetex`
* macOS: `brew install texlive`
* Building and Publishing
* uv sync
* uv build
* uv publish

* Debugging: MCP Inspector is recommended, launched via npm.

🎯 Conclusion:
The `mcp-pandoc` GitHub repository provides the necessary information for understanding, installing, using, developing, and contributing to the document conversion server. PDF conversion requires specific software installations, and usage instructions emphasize the importance of complete file paths and supported formats.