mcp-pandoc — это MCP-сервер для конвертации документов между различными форматами, который использует движок Pandoc и позволяет AI-агентам преобразовывать контент с полным сохранением форматирования и структуры, включая поддержку двунаправленной конвертации между девятью форматами, работу с YAML-шаблонами и кастомными фильтрами.
Ключевые особенности:
Полная матрица двунаправленной конвертации: Поддерживает взаимное преобразование между Markdown, HTML, TXT, DOCX, RST, LaTeX, EPUB, IPYNB и ODT — всего 81 возможное направление конвертации с сохранением структуры документа.
Инструмент convert-contents: Принимает на вход строку с контентом или путь к файлу, исходный и целевой форматы, и выполняет преобразование — для базовых форматов результат отображается прямо в чате с AI-ассистентом, для продвинутых требует указания пути выходного файла.
Поддержка YAML-файлов настроек (defaults files): Позволяет создавать переиспользуемые шаблоны конвертации с заданными параметрами — нумерация секций, автособираемое оглавление, метаданные документа и другие опции Pandoc, зафиксированные в одном конфигурационном файле.
Система pandoc-фильтров: Поддерживает подключение внешних фильтров для расширенной обработки контента при конвертации — например, фильтр для преобразования Mermaid-диаграмм в изображения прямо в процессе генерации выходного документа.
Стилизация DOCX через reference document: Даёт возможность применять кастомные шаблоны оформления при генерации DOCX-файлов — сначала создаётся эталонный документ с нужными стилями, затем он используется как образец при каждой последующей конвертации.
Для кого: Ориентирован на разработчиков, технических писателей, исследователей и контент-менеджеров, которые работают с документацией в AI-средах (Claude Desktop, Cursor, VS Code и других MCP-совместимых клиентах) и нуждаются в автоматическом преобразовании материалов между форматами без выхода из рабочего процесса.
Сценарии использования:
Разработчик в Claude Desktop пишет техническую документацию в Markdown и одной командой конвертирует её в стилизованный DOCX с корпоративным шаблоном для отправки заказчику, не открывая Word.
Исследователь преобразует Jupyter-ноутбук (IPYNB) с кодом и графиками в LaTeX, затем генерирует PDF с автоматическим оглавлением и нумерацией разделов, используя заранее подготовленный YAML-файл настроек.
Технический писатель конвертирует HTML-страницы веб-документации в Markdown для последующей публикации в GitHub-репозитории, затем обратно генерирует EPUB для распространения в виде электронной книги.
Команда применяет Mermaid-фильтр при конвертации Markdown в HTML, чтобы все диаграммы в документации автоматически рендерились в статические изображения, готовые к публикации на сайте.
Цены и доступность: Проект полностью с открытым исходным кодом, официально включён в каталог серверов Model Context Protocol и распространяется через PyPI. Установка бесплатна и выполняется одной командой через uvx mcp-pandoc или npx @smithery/cli. Никаких платных тарифных планов или коммерческих лицензий не предусмотрено — единственным техническим требованием является предустановленный Pandoc и опционально TeX Live для генерации PDF.
