mcp-pandoc

Что умеет сервер

mcp-pandoc даёт агенту один инструмент, convert-contents, и опирается на установленный в системе pandoc. Исходным может быть текст в запросе (contents) или файл (input_file), формат указывают в input_format и output_format. Читаются markdown, html, docx, odt, rst, latex, epub, ipynb и txt. Записываются те же форматы плюс pdf и pptx; читать pdf и pptx сервер не умеет.

Для форматов docx, odt, pptx, pdf, rst, latex и epub нужно указать полный путь output_file. Стили можно задавать документом-образцом reference_doc (для docx, odt и pptx, формат образца должен совпадать с выходным), файлом настроек Pandoc defaults_file в YAML и фильтрами Pandoc. Так получаются, например, брендированные презентации из Markdown или отчёты с оглавлением и нумерацией разделов.

Когда использовать

Сервер удобен, когда Claude уже написал текст в Markdown и его нужно превратить в Word для отправки, в PDF для печати, в EPUB или презентацию PowerPoint, а также наоборот, из DOCX или HTML в Markdown для дальнейшего разбора. Если нужно править внутри существующего файла Word или Excel (комментарии, формулы, исправления), лучше подойдут специализированные серверы и навыки: pandoc конвертирует документ целиком.

Ограничения и безопасность

В README сказано, что проект находится на ранней стадии разработки: возможности и набор инструментов могут меняться. Конвертация в PDF требует установленного TeX Live (на Windows MiKTeX или TeX Live), без него возникает ошибка xelatex not found. Для сложных форматов обязателен полный путь с именем и расширением, сервер сам имён не придумывает.

Входной формат pptx не поддерживается, потому что проект не требует определённой версии pandoc, а чтение PowerPoint появилось в pandoc 3.8.3. Если документ-образец не соответствует выходному формату, для DOCX он молча игнорируется, а для ODT получится нечитаемый файл.

Сервер читает и записывает файлы по путям, которые передаёт модель, и ограничений по каталогам в README нет. Давайте ему доступ только туда, где допустима перезапись.

Перед использованием установите pandoc и uv (в нём команда uvx).

# macOS
brew install pandoc

# Ubuntu/Debian
sudo apt-get install pandoc

# Windows
# Download installer from: https://pandoc.org/installing.html

# macOS
brew install uv

# Windows/Linux
pip install uv

Для конвертации в PDF дополнительно нужен TeX Live:

# Ubuntu/Debian
sudo apt-get install texlive-xetex

# macOS
brew install texlive

Claude Desktop

Откройте claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) и добавьте опубликованную конфигурацию:

{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "uvx",
      "args": ["mcp-pandoc"]
    }
  }
}

README описывает установку только для Claude Desktop. Примеры запросов из README:

Convert /path/to/input.md to PDF and save as /path/to/output.pdf
Convert input.md to DOCX using template.docx as reference and save as output.docx