MCP.so
登录

mcp-pandoc: A Document Conversion MCP Server

@vivekVells

关于 mcp-pandoc: A Document Conversion MCP Server

MCP server for document format conversion using pandoc.

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

vivekVells

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "mcp-pandoc",
        "--client",
        "claude"
      ]
    }
  }
}

工具

2

`contents` (string): Source content to convert (required if input_file not provided)

For advanced formats (pdf, docx, rst, latex, epub), an output_file path is required

概览

What is mcp-pandoc?

mcp-pandoc is a Model Context Protocol server for document format conversion using pandoc. It provides tools to transform content between different document formats while preserving formatting and structure, and is officially included in the Model Context Protocol servers open-source project.

How to use mcp-pandoc?

Install pandoc and the uv package manager, then configure your MCP client (e.g., Claude Desktop) with the mcpServers entry using uvx mcp-pandoc. The server exposes one tool, convert-contents, which accepts source content or an input file, source/target formats, an optional output file, a reference document for DOCX styling, a defaults file, and Pandoc filters.

Key features of mcp-pandoc

  • Single tool convert-contents for all conversions
  • Supports 10 formats: markdown, HTML, TXT, DOCX, PDF, RST, LaTeX, EPUB, IPYNB, ODT
  • Bidirectional conversion between all supported formats (PDF output only)
  • Advanced features: defaults files (YAML) and Pandoc filters
  • DOCX output supports custom styling via reference documents
  • Basic conversions display in chat; advanced formats require output file path

Use cases of mcp-pandoc

  • Convert Markdown notes to PDF or DOCX documents
  • Convert HTML content to EPUB for e‑readers
  • Transform Jupyter notebooks (IPYNB) to Markdown or HTML
  • Batch convert multiple files between formats using defaults templates
  • Produce styled DOCX files with custom reference document templates

FAQ from mcp-pandoc

How do I convert content using the convert-contents tool?

Provide either the contents string or an input_file path, plus the desired input_format and output_format. For advanced formats (PDF, DOCX, RST, LaTeX, EPUB) you must also supply an output_file path.

Does mcp-pandoc support PDF conversion?

PDF is supported as an output‑only format. Converting from PDF to other formats is not supported. PDF generation requires TeX Live to be installed.

What are the critical requirements before using mcp-pandoc?

You must install pandoc itself, the uv package manager (which provides the uvx command), and optionally TeX Live for PDF output. Complete file paths with filename and extension are mandatory when saving files.

Can I customize the styling of DOCX output?

Yes, you can provide a reference document (.docx or created via pandoc -o reference.docx --print-default-data-file reference.docx) to override default styles. This works only for DOCX output.

What formats are supported and what are the format categories?

Formats are split into Basic (MD, HTML, TXT, IPYNB, ODT – no extra requirements) and Advanced (DOCX, PDF, RST, LaTeX, EPUB – require an output file path). All formats can be bidirectionally converted except PDF (output only).

评论

其他 分类下的更多 MCP 服务器