MarkItDown
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Установка
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
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Набор плагинов Anthropic для юристов: договоры, приватность, трудовое право, IP, судебные дела, AI-регулирование и обучение
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует проверенные схемы архитектуры, процессов, последовательностей и потоков данных в один интерактивный HTML-файл