mcp-pandoc
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
- 584 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает файлы по указанным путям и записывает результат в файл по заданному пути
- Параметр filters запускает выбранные фильтры pandoc, то есть выполняет программы на вашем компьютере
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-pandocОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает файлы по указанным путям и записывает результат в файл по заданному пути
- Параметр filters запускает выбранные фильтры pandoc, то есть выполняет программы на вашем компьютере
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-pandoc дает агенту один инструмент, `convert-contents`, который переводит документы из одного формата в другой через установленный на компьютере pandoc. Источником служит либо текст прямо в запросе, либо путь к файлу. Читать можно Markdown, HTML, DOCX, ODT, RST, LaTeX, EPUB, IPYNB и обычный текст, записывать в те же форматы, а еще в PDF и PPTX. Форматы Markdown, HTML, TXT и IPYNB результат возвращает прямо в чат. Для остальных нужен полный путь выходного файла с именем и расширением. DOCX, ODT и PPTX можно оформить по образцу: параметр `reference_doc` берет стили из документа того же формата, что и результат. Для повторяющихся задач есть два расширения. Файл настроек pandoc в формате YAML задает постоянные параметры вроде оглавления и нумерации разделов, а список фильтров подключает собственные обработчики, например для диаграмм. Запросы пишутся обычными фразами: «преобразуй paper.md в PDF по настройкам academic-paper.yaml и сохрани как paper.pdf».
Для кого. Для технических писателей, преподавателей и разработчиков, которые готовят документы, статьи и презентации и хотят переводить их между форматами фразами в чате.
Подходит, если
- Статья написана в Markdown, и из нее нужны DOCX для редактора, PDF для печати и HTML для публикации
- Нужно оформить DOCX, ODT или PPTX по корпоративному образцу: образец передают параметром `reference_doc`
- Заметки из блокнота Jupyter надо превратить в читаемый документ или обратно
- Нужны постоянные параметры PDF вроде оглавления и нумерации разделов, которые задаются YAML-файлом настроек
- Пришел DOCX или EPUB, и его нужно быстро перевести в Markdown, чтобы агент мог с ним работать
Не подходит, если
- Нужно прочитать готовый PDF или PPTX: pandoc эти форматы только создает, а читать не умеет
- Нельзя ставить программы на компьютер: серверу требуются pandoc и uv, а для PDF еще TeX Live
- Нужно править содержимое документа: сервер только меняет формат и текст не редактирует
- Нужно прочитать таблицу Excel: такого формата нет в списке входных
Пример запроса к агенту
Преобразуй /Users/me/docs/report.md в DOCX по образцу /Users/me/docs/template.docx и сохрани как /Users/me/docs/report.docxMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Проект на ранней стадии: автор предупреждает, что набор инструментов и возможности могут меняться. Нужны pandoc, менеджер пакетов uv с командой `uvx` и Python 3.11 или новее. Для PDF дополнительно ставится TeX Live; без него конвертация падает с ошибкой «xelatex not found».
Форматы PDF и PPTX можно получить, но нельзя прочитать. Читателя PDF у pandoc никогда не было. Читатель PPTX появился в версии 3.8.3, но проект не требует минимальной версии pandoc, и в Ubuntu 24.04 стоит 3.1.3, поэтому такой ввод не предлагается. Для расширенных форматов (PDF, DOCX, ODT, PPTX, RST, LaTeX, EPUB) обязателен полный путь выходного файла, иначе результат может оказаться во временной папке.
Файл образца для `reference_doc` должен быть того же формата, что и результат. Pandoc этого не проверяет: несовпадающий образец для DOCX молча игнорируется, а для ODT дает файл, который не открывается.
Как отключить. Удалите блок mcp-pandoc из конфигурации MCP-клиента, например из claude_desktop_config.json, и перезапустите клиент. Установленные pandoc и uv можно оставить: сервер их не меняет.
Частые вопросы
Как подключить mcp-pandoc к Claude Desktop?
Сначала установите pandoc и uv. Затем откройте claude_desktop_config.json (в macOS он лежит в ~/Library/Application Support/Claude/, а в Windows лежит в %APPDATA%/Claude/) и добавьте сервер mcp-pandoc с командой uvx и аргументом mcp-pandoc. После перезапуска Claude Desktop инструмент convert-contents станет доступен.
Почему не получается сохранить PDF?
Для PDF нужен TeX Live. Если его нет, сервер сообщает об ошибке «xelatex not found». В Ubuntu и Debian ставьте пакет `texlive-xetex`, в macOS выполните `brew install texlive`, в Windows поставьте MiKTeX или TeX Live. Путь сохранения должен быть полным и с расширением .pdf.
Какие форматы mcp-pandoc читает и какие записывает?
Читает Markdown, HTML, DOCX, ODT, RST, LaTeX, EPUB, IPYNB и TXT. Записывает те же форматы, а еще PDF и PPTX. PDF и PPTX на вход не принимаются. Читателя PDF у pandoc нет, чтение PPTX в проекте не предлагается.
Как оформить DOCX по готовому образцу?
Передайте путь к образцу в параметре reference_doc: сервер возьмет из него стили. Образец должен быть DOCX, если результат DOCX, ODT для ODT и PPTX для PPTX. Чтобы создать исходный образец, выполните `pandoc -o custom-reference.docx --print-default-data-file reference.docx` и отредактируйте файл в Word.
Можно ли подключить собственные фильтры pandoc?
Да, список путей к фильтрам передают параметром filters. Пример из документации: преобразовать docs.md в HTML с фильтром mermaid-filter.py и сохранить как docs.html. Постоянные параметры вроде оглавления и нумерации собирают в YAML-файл и подключают параметром defaults_file.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
Скилл для конвертации Markdown в Word и обратно через Pandoc с готовыми шаблонами оформления и Lua-фильтрами
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-pandoc (эта запись) | нет | не нужна | 584 | |
| MarkItDown | да | не нужна | 192 901 | переводит PDF, Word, Excel, PowerPoint и другие файлы в Markdown для модели |
| pandoc-docx-template | нет | 1 102 | скилл для перевода Markdown в Word и обратно с готовыми шаблонами оформления и фильтрами Lua | |
| Overleaf MCP Server | нет | API-ключ | 334 | MCP-сервер для Overleaf |
Коротко о README
README открывается описанием сервера и ссылкой на шпаргалку с примерами. Затем описан единственный инструмент и его параметры, таблица форматов с направлением чтения и записи и матрица конвертаций. В разделе про настройку приведены конфигурации для опубликованной и локальной версий, требования к pandoc, uv и TeX Live, примеры правильных и неправильных запросов и разбор типичных ошибок. В конце идут разработка, тесты, сборка и отладка через MCP Inspector.