vivekvells/mcp-pandoc

vivekvells/mcp-pandoc

от vivekvells
Конвертирует документы между Markdown, PDF, DOCX и другими через Pandoc. Работает с файлами и текстом, сохраняет оформление.

Downloads CI

image

MseeP.ai Security Assessment Badge

mcp-pandoc: A Document Conversion MCP Server

Officially included in the Model Context Protocol servers open-source project. 🎉

Overview

A Model Context Protocol server for document format conversion using pandoc. This server provides tools to transform content between different document formats while preserving formatting and structure.

Please note that mcp-pandoc is currently in early development. PDF support is under development, and the functionality and available tools are subject to change and expansion as we continue to improve the server.

Credit: This project uses the Pandoc Python package for document conversion, forming the foundation for this project.

📋 Quick Reference

New to mcp-pandoc? Check out 📖 CHEATSHEET.md for

  • ⚡ Copy-paste examples for all formats
  • 🔄 Bidirectional conversion matrix
  • 🎯 Common workflows and pro tips
  • 🌟 Reference document styling guide

Perfect for quick lookups and getting started fast!

Demo

mcp-pandoc - v1: Seamless Document Format Conversion for Claude using MCP server

🎥 Watch on YouTube

Screenshots
Screenshot 2024-12-26 at 3 33 54 PM Screenshot 2024-12-26 at 3 38 24 PM Screenshot 2024-12-26 at 3 40 51 PM Screenshot 2024-12-26 at 3 41 20 PM Screenshot 2024-12-26 at 3 50 27 PM

More to come...

Tools

  1. convert-contents
    • Transforms content between supported formats

    • Inputs:

      • contents (string): Source content to convert (required if input_file not provided)
      • input_file (string): Complete path to input file (required if contents not provided)
      • input_format (string): Source format of the content (defaults to markdown)
      • output_format (string): Target format (defaults to markdown)
      • output_file (string): Complete path for output file (required for pdf, docx, rst, latex, epub, odt, pptx formats)
      • reference_doc (string): Path to a reference document to use for styling (supported for docx, odt and pptx output; the file must match the output format)
      • defaults_file (string): Path to a Pandoc defaults file (YAML) containing conversion options
      • filters (array): List of Pandoc filter paths to apply during conversion
    • Supported formats, by direction:

      Format Read Write
      markdown ✅ ✅
      html ✅ ✅
      docx ✅ ✅
      odt ✅ ✅
      rst ✅ ✅
      latex ✅ ✅
      epub ✅ ✅
      ipynb ✅ ✅
      txt ✅ ✅
      pdf ❌ ✅
      pptx ❌ ✅
    • Note: For advanced formats (pdf, docx, rst, latex, epub, odt, pptx), an output_file path is required

Часто задаваемые вопросы

Инструменты были проиндексированы:
convert-contents

Преобразует содержимое между разными форматами. Переводит входное содержимое из любого поддерживаемого формата в указанный выходной формат. 🚨 КРИТИЧЕСКИЕ ТРЕБОВАНИЯ - ОБЯЗАТЕЛЬНО ПРОЧТИТЕ: 1. Конвертация в PDF: * ВЫ ОБЯЗАНЫ установить TeX Live ДО попытки конвертации в PDF: * Ubuntu/Debian: sudo apt-get install texlive-xetex * macOS: brew install texlive * Windows: Установите MiKTeX или TeX Live с https://miktex.org/ или https://tug.org/texlive/ * Конвертация в PDF НЕ СРАБОТАЕТ без этой установки 2. Пути к файлам - ЯВНЫЕ ТРЕБОВАНИЯ: * Когда вас просят сохранить или преобразовать в файл, ВЫ ОБЯЗАНЫ указать: - Полный путь к каталогу - Имя файла - Расширение файла * Пример запроса: 'Напиши рассказ и сохрани как PDF' * ВЫ ОБЯЗАНЫ указать: '/path/to/story.pdf' или 'C:\Documents\story.pdf' * Инструмент НЕ будет автоматически создавать имена файлов или расширения 3. Расположение файла после конвертации: * После успешной конвертации инструмент покажет точный путь, куда сохранён файл * Ищите сообщение: 'Content successfully converted and saved to: [file_path]' * Свой преобразованный файл вы найдёте по указанному пути * Если путь не указан, файлы могут сохраниться во временном каталоге системы (/tmp/ в Unix-системах) * Чтобы лучше контролировать процесс, всегда указывайте явные пути к выходным файлам Поддерживаемые форматы:- Базовые: txt, html, markdown, ipynb, odt- Расширенные (ТРЕБУЮТ полные пути к файлам): pdf, docx, rst, latex, epub✅ ПРАВИЛЬНЫЕ примеры использования: 1. 'Преобразуй этот текст в HTML' (базовая конвертация) - Инструмент покажет преобразованное содержимое 2. 'Сохрани этот текст как PDF по пути /documents/story.pdf' - Правильно: указаны путь + имя файла + расширение - Инструмент покажет: 'Content successfully converted and saved to: /documents/story.pdf' ❌ НЕПРАВИЛЬНЫЕ примеры использования: 1. 'Сохрани это как PDF в /documents/' - Не хватает имени файла и расширения 2. 'Преобразуй в PDF' - Не хватает полного пути к файлу Когда запрашиваете конвертацию, ВСЕГДА указывайте: 1. Содержимое или входной файл 2. Желаемый выходной…

Параметры
  • contentsstring

    Контент для преобразования (обязателен, если не указан input_file)

  • defaults_filestring

    Путь к файлу параметров Pandoc по умолчанию (YAML), содержащему параметры преобразования. Аналогично использованию опции -d в pandoc.

  • filtersstring[]

    Список путей к фильтрам Pandoc для применения во время конвертации. Фильтры применяются в указанном порядке.

  • input_filestring

    Полный путь к входному файлу, включая имя файла и расширение (например, '/path/to/input.md')

  • input_formatenum

    Формат исходного содержимого (по умолчанию — markdown)

  • output_filestring

    Полный путь, куда сохранить результат, включая имя файла и расширение (обязательно для форматов pdf, docx, rst, latex, epub)

  • output_formatenum

    Желаемый формат вывода (по умолчанию markdown)

  • reference_docstring

    Путь к эталонному документу для оформления (поддерживается для выходного формата docx)

0.11.1основная
0.11.0
0.10.0
0.9.0
0.8.2
0.8.1
0.8.0
0.5.0
0.4.0
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.1
0.2.0
0.1.0

Выберите клиент, чтобы установить vivekvells/mcp-pandoc:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "vivekvells-mcp-pandoc-w5nu6zma9b": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "vivekvells-mcp-pandoc-w5nu6zma9b": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"vivekvells-mcp-pandoc-w5nu6zma9b\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-pandoc\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "vivekvells-mcp-pandoc-w5nu6zma9b": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add vivekvells-mcp-pandoc-w5nu6zma9b -- uvx mcp-pandoc

Либо через JSON-конфиг:

claude mcp add-json vivekvells-mcp-pandoc-w5nu6zma9b "{\"command\":\"uvx\",\"args\":[\"mcp-pandoc\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add vivekvells-mcp-pandoc-w5nu6zma9b -- uvx mcp-pandoc

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.vivekvells-mcp-pandoc-w5nu6zma9b]
command = "uvx"
args = ["mcp-pandoc"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите vivekvells/mcp-pandoc, а в поле команды запуска — строку ниже:
uvx mcp-pandoc

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "vivekvells-mcp-pandoc-w5nu6zma9b": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например vivekvells-mcp-pandoc-w5nu6zma9b.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: vivekvells-mcp-pandoc-w5nu6zma9b
    command: uvx
    args:
      - "mcp-pandoc"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "vivekvells-mcp-pandoc-w5nu6zma9b": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}

Похожие MCP-сервера

UseJunior/safe-docx

UseJunior/safe-docx

от usejunior

Safe Docx — MCP сервер для хирургического редактирования существующих .docx и .odt файлов без потери форматирования. Помогает разработчикам и юристам автоматизировать правки контрактов через ИИ-агентов. Поддерживает отслеживание изменений, комментарии и сноски, сохраняя структуру документа.

TypeScript⭐ 46
AryanBV/pdf-toolkit-mcp

AryanBV/pdf-toolkit-mcp

от aryanbv

MCP сервер с 22 инструментами для чтения, создания и редактирования PDF с AES-256 шифрованием. Умеет создавать PDF из Markdown, рендерить страницы для vision-моделей и заполнять формы. Работает чер...

TypeScript⭐ 11
ofershap/mcp-server-markdown

ofershap/mcp-server-markdown

от ofershap

MCP сервер для поиска и навигации по локальным markdown-файлам: полнотекстовый поиск, извлечение разделов по заголовкам, навигация по оглавлению, поиск блоков кода по языку и парсинг frontmatter. П...

TypeScript⭐ 8
laradji/deadzone

laradji/deadzone

от laradji

Deadzone — векторный индекс для семантического поиска по документации, работающий как локальный MCP-сервер. Полезен разработчикам AI-агентов, которым нужен поиск по документам без интернета. Исполь...

Go⭐ 4
FacundoLucci/plsreadme

FacundoLucci/plsreadme

от facundolucci

MCP сервер plsreadme превращает markdown в красивые веб-страницы и создаёт ссылки для шаринга. Помогает разработчикам и редакторам публиковать README, PRD и заметки. Работает с AI-редакторами (Claude, Cursor), поддерживает комментирование и версионирование.

TypeScript⭐ 4
UnMarkdown/mcp-server

UnMarkdown/mcp-server

от unmarkdown

MCP сервер Unmarkdown преобразует Markdown в документы для Google Docs, Word, Slack и других платформ с 62 шаблонами. Управляет документами и публикует страницы. Идеален для AI-ассистентов, которым нужно быстро оформлять и публиковать контент.

JavaScript⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин