MarkItDown

Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели

MCP-серверВыбор редакцииСредний риск

microsoft/markitdown

Установка

pip install markitdown-mcp
markitdown-mcp

Запуск через stdio. Для HTTP: markitdown-mcp --http --host 127.0.0.1 --port 3001.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MarkItDown конвертирует документы в Markdown с сохранением структуры: заголовков, списков, таблиц и ссылок. Поддерживаются PDF, DOCX, PPTX, XLSX и XLS, HTML, CSV, JSON, XML, EPUB, ZIP-архивы, картинки с метаданными и OCR, аудио с транскрипцией и ссылки на YouTube. В репозитории есть пакет markitdown-mcp: MCP-сервер с одним инструментом convert_to_markdown, который принимает адреса http, https, file и data. Сервер работает через stdio, Streamable HTTP или SSE и запускается локально или в Docker.

Для кого. Для всех, кто подает агенту офисные документы и PDF и хочет компактный текст вместо сырых файлов.

Подходит, если

  • Агенту нужно прочитать договор в PDF или таблицу Excel
  • Нужно подготовить набор документов для RAG
  • Нужна расшифровка аудио или субтитры YouTube в тексте

Не подходит, если

  • Нужна точная верстка документа для человека, а не текст для модели
  • Нужно обрабатывать файлы из недоверенных источников без изоляции

Пример запроса к агенту

Преобразуй отчет report.pdf в Markdown и выпиши из таблиц все показатели за второй квартал

Ограничения

Нужен Python 3.10 или новее, поддержка форматов ставится через дополнительные зависимости. OCR через плагин markitdown-ocr требует клиента OpenAI-совместимой модели, а режимы Azure требуют подписки. Инструмент выполняет ввод-вывод с правами процесса, поэтому HTTP-режим сервера нельзя открывать наружу.

Как отключить. Удалите сервер markitdown из конфигурации MCP и пакеты командой pip uninstall markitdown-mcp markitdown.

MCP

Транспорт
stdio, http, sse
Авторизация
не нужна

Проверка безопасности

  • Читает локальные файлы и загружает данные по URL с правами процесса
  • Обрабатывает содержимое документов, в котором может быть внедрение подсказок

Коротко о README

README объясняет выбор Markdown: модели хорошо его понимают, а разметка экономит токены. Описаны установка через pip с выбором зависимостей по форматам, работа из командной строки и Python, сторонние плагины и плагин OCR, интеграции с Azure Document Intelligence и Content Understanding. Отдельный README пакета markitdown-mcp дает запуск через stdio, HTTP и Docker и конфигурацию для Claude Desktop. Лицензия MIT.

Частые вопросы

Можно без MCP?

Да, после pip install 'markitdown[all]' доступна команда markitdown file.pdf -o document.md и Python API.

Как дать доступ к локальным файлам в Docker?

Смонтируйте каталог в /workdir, файлы будут доступны по этому пути внутри контейнера.

Выбор редакции

Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills

СкиллСредний риск176,3 тыс.
Выбор редакции

Набор плагинов Anthropic для юристов: договоры, приватность, трудовое право, IP, судебные дела, AI-регулирование и обучение

ПлагинСредний риск9,4 тыс.
Выбор редакции

Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями

СкиллСредний риск

Скилл рисует проверенные схемы архитектуры, процессов, последовательностей и потоков данных в один интерактивный HTML-файл

СкиллСредний риск62,1 тыс.