How do I use flexberry-markitdown-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@flexberry-markitdown-mcp convert meeting_notes.docx to markdown" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

flexberry-markitdown-mcp

Official

by Flexberry

Overview Schema Source Related Servers Discussions Admin

Python

Local

Flexberry MarkItDown MCP Server

GitHub License: MIT PyPI version

MCP-сервер для двунаправленной конвертации документов:

Любой формат → Markdown (через Microsoft MarkItDown)
Markdown → PDF (через Playwright / headless Chromium — подход из vscode-markdown-pdf)

Использует:

Microsoft MarkItDown — конвертация любых форматов в Markdown
Подход vscode-markdown-pdf — генерация PDF через headless Chromium

Установка — одна команда

pip install flexberry-markitdown-mcp

Всё! При первом вызове convert_to_pdf Chromium скачается автоматически (как в vscode-markdown-pdf).

Дополнительные опции

# Легковесный бэкенд без браузера (не поддерживает JS-рендеринг)
pip install flexberry-markitdown-mcp[weasyprint]

# Для разработки
pip install flexberry-markitdown-mcp[dev]

Related MCP server: MarkItDown MCP Server

Возможности

Конвертация в Markdown (`convert_to_markdown`)

30+ форматов: PDF, DOCX, PPTX, XLSX, HTML, изображения (OCR), аудио (транскрипция), EPUB, ZIP...
Поддержка кириллицы в именах файлов и содержимом
Атомарная запись (временный файл + переименование)

Конвертация в PDF (`convert_to_pdf`)

Playwright (по умолчанию) — headless Chromium, как в vscode-markdown-pdf
- Chromium скачивается автоматически при первом использовании
- Поддержка JavaScript-рендеринга (Mermaid, PlantUML и т.д.)
- Колонтитулы с номерами страниц
WeasyPrint (опционально) — чистый Python, без браузера
GitHub-стиль оформления (таблицы, код, блок-схемы)
Подсветка синтаксиса через Pygments
Настраиваемый формат страницы, поля, CSS

Настройка MCP-клиента

Claude Desktop / RooCode / Cursor

{
  "mcpServers": {
    "flexberry-markitdown": {
      "command": "python3",
      "args": ["-m", "flexberry_markitdown_mcp.server"]
    }
  }
}

Через uv

{
  "mcpServers": {
    "flexberry-markitdown": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/flexberry-markitdown-mcp",
        "run", "flexberry-markitdown-mcp"
      ]
    }
  }
}

Инструменты

`convert_to_markdown`

Конвертирует файл любого поддерживаемого формата в Markdown.

Параметр	Тип	Обязательный	Описание
`file_path`	string	✅	Абсолютный путь к файлу
`output_path`	string	❌	Пользовательский путь вывода
`overwrite`	boolean	❌	Перезаписать существующий (по умолч.: false)

`convert_to_pdf`

Конвертирует Markdown-файл в PDF. Бэкенд по умолчанию — Playwright (как в vscode-markdown-pdf).

Параметр	Тип	Обязательный	Описание
`file_path`	string	✅	Абсолютный путь к .md файлу
`output_path`	string	❌	Пользовательский путь вывода PDF
`backend`	string	❌	`"playwright"` (по умолч.) или `"weasyprint"`
`overwrite`	boolean	❌	Перезаписать существующий (по умолч.: false)
`custom_css`	string	❌	Дополнительный CSS
`include_default_styles`	boolean	❌	Включить встроенные стили (по умолч.: true)
`format`	string	❌	Формат бумаги: A4, Letter и т.д. (по умолч.: A4)
`margin_top`	string	❌	Верхнее поле (по умолч.: 1.5cm)
`margin_bottom`	string	❌	Нижнее поле (по умолч.: 1cm)
`margin_left`	string	❌	Левое поле (по умолч.: 1cm)
`margin_right`	string	❌	Правое поле (по умолч.: 1cm)
`print_background`	boolean	❌	Печатать фон (по умолч.: true)
`display_header_footer`	boolean	❌	Колонтитулы (по умолч.: true, Playwright)

`get_supported_formats`

Список поддерживаемых форматов и доступные PDF-бэкенды.

`check_file_exists`

Проверяет существование файла и возвращает информацию.

`list_directory`

Показывает содержимое директории.

Архитектура

┌──────────────────────────────────────────────────────┐
│                   MCP Server (stdio)                  │
├──────────────────────────────────────────────────────┤
│                                                       │
│  convert_to_markdown          convert_to_pdf          │
│  ┌───────────────┐            ┌──────────────────┐   │
│  │  MarkItDown   │            │  markdown-it-py  │   │
│  │  (any→MD)     │            │  (MD→HTML)       │   │
│  └───────┬───────┘            └────────┬─────────┘   │
│          │                             │              │
│          ▼                             ▼              │
│  ┌───────────────┐            ┌──────────────────┐   │
│  │  Atomic write │            │  HTML template   │   │
│  │  (MD to disk) │            │  + GitHub CSS    │   │
│  └───────────────┘            └────────┬─────────┘   │
│                                        │              │
│                              ┌─────────┴──────────┐  │
│                              ▼                    ▼  │
│                     ┌──────────────┐  ┌────────────┐ │
│                     │  Playwright  │  │ WeasyPrint │ │
│                     │  (DEFAULT)   │  │ (optional) │ │
│                     │  Chromium    │  │ Pure Python│ │
│                     │  auto-d/l    │  │ No JS      │ │
│                     └──────┬───────┘  └─────┬──────┘ │
│                            ▼                ▼        │
│                     ┌─────────────────────────────┐  │
│                     │      PDF saved to disk      │  │
│                     └─────────────────────────────┘  │
└──────────────────────────────────────────────────────┘

Сравнение бэкендов PDF

Характеристика	Playwright (по умолч.)	WeasyPrint (опционально)
Установка	Автоматически при `pip install`	`pip install ...[weasyprint]`
Chromium	Автозагрузка при первом запуске	Не нужен
JavaScript	✅ Полная поддержка	❌
Mermaid/PlantUML	✅	❌
Колонтитулы	✅ Номера страниц	Через CSS @page
Рекомендация	Все документы	Легковесный fallback

Журналирование

Журналы сервера сохраняются в:

Linux: ~/.flexberry-markitdown-mcp/server.log
Windows: C:\Users\<user>\.flexberry-markitdown-mcp\server.log

Устранение неполадок

Ошибка: "MarkItDown not installed"

pip install flexberry-markitdown-mcp

Ошибка: "MCP module not found"

pip install flexberry-markitdown-mcp

Проблемы с кириллицей в Windows

Убедитесь, что в терминале используется кодировка UTF-8. Сервер автоматически устанавливает UTF-8 для stdin/stdout/stderr.

OCR не работает для изображений

Установите Tesseract:

Windows: загрузите с https://github.com/UB-Mannheim/tesseract/wiki
Linux: sudo apt install tesseract-ocr (Ubuntu/Debian)

Для русского языка установите языковой пакет:

Windows: выберите русский язык во время установки
Linux: sudo apt install tesseract-ocr-rus

Транскрипция аудио не работает

MarkItDown использует Azure Speech Services для транскрипции. Убедитесь, что переменные среды настроены.

Chromium не скачивается автоматически

playwright install chromium

Разработка

Запуск тестов

pip install -e ".[dev]"
pytest

Структура проекта

flexberry-markitdown-mcp/
├── src/
│   └── flexberry_markitdown_mcp/
│       ├── __init__.py
│       ├── converter.py     # MD → PDF конвертация
│       ├── server.py        # MCP сервер
│       └── styles.py        # CSS стили для PDF
├── tests/
│   └── test_converter.py
├── pyproject.toml
└── README.md

Лицензия

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

Mdkit A
online.mdkit
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Developer Tools RAG Systems Data Platforms
31
PDF to Markdown (pdf2md.dev)
dev.pdf2md
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
AI & Machine Learning Image & Video Processing
2
stagenth · 文档生成 A
com.stagenth
Generate PDF, Word (.docx) and PowerPoint (.pptx) documents from Markdown over MCP.
File Systems Workplace & Productivity
33
Speechtotext Mcp
io.github.varvararatta
MCP server for Speech-to-Text
Speech Processing AI & Machine Learning
2

Related MCP Servers

md2doc
Developer Tools App Automation Workplace & Productivity
Yorick-Ryu
A
license
Not graded
quality
C
maintenance
An MCP server that converts Markdown text to DOCX format using an external conversion service. It supports custom templates, multi-language output, and provides flexible file handling for both local and cloud-based deployments.
Updated 5 months ago (2026-04-13 11:26 UTC)
7
MIT
MarkItDown MCP Server
Multimedia Processing File Systems
sourav-spd
A
license
Not graded
quality
D
maintenance
A production-ready MCP server for converting documents and files to Markdown using Microsoft MarkItDown.
Updated 3 months ago (2026-07-01 10:16 UTC)
MIT
Huoshui File Converter
File Systems Developer Tools
huoshuiai42
A
license
A
quality
D
maintenance
A secure MCP server for converting documents between Markdown, DOCX, HTML, PDF, and TXT formats within a sandboxed working directory.
Updated a year ago (2025-09-10 00:41 UTC)
3
MIT
huoshui-pdf-converterofficial
Developer Tools
huoshuiai42
A
license
A
quality
D
maintenance
An MCP server for high-quality bidirectional PDF ↔ Markdown conversion with full Unicode/CJK character support, enabling users to convert files via natural language commands.
Updated a year ago (2025-09-09 23:55 UTC)
4
MIT