MarkItDown MCP
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
- 192 752 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает локальные файлы и загружает данные по URL с правами процесса
- Обрабатывает содержимое документов, в котором может быть внедрение подсказок
Установка
- Работает в
Ручная установка
pip install markitdown-mcp
markitdown-mcpЗапуск через stdio. Для HTTP: markitdown-mcp --http --host 127.0.0.1 --port 3001.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает локальные файлы и загружает данные по URL с правами процесса
- Обрабатывает содержимое документов, в котором может быть внедрение подсказок
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
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 и выпиши из таблиц все показатели за второй кварталMCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Ограничения
Нужен Python 3.10 или новее, поддержка форматов ставится через дополнительные зависимости. OCR через плагин markitdown-ocr требует клиента OpenAI-совместимой модели, а режимы Azure требуют подписки. Инструмент выполняет ввод-вывод с правами процесса, поэтому HTTP-режим сервера нельзя открывать наружу.
Как отключить. Удалите сервер markitdown из конфигурации MCP и пакеты командой pip uninstall markitdown-mcp markitdown.
Частые вопросы
Можно без MCP?
Да, после pip install 'markitdown[all]' доступна команда markitdown file.pdf -o document.md и Python API.
Как дать доступ к локальным файлам в Docker?
Смонтируйте каталог в /workdir, файлы будут доступны по этому пути внутри контейнера.
Обсуждение
- бывший участникВопрос
Кто нибудь уже ставил? Какие ощущения?
- бывший участник
Лучший ответ
да норм
Похожие
MCP-серверыMCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
MCP Word для правки документов docx с рецензированием: вставки и удаления видны в Word, комментарии, сноски, сравнение версий и журнал изменений
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MarkItDown (эта запись) | да | не нужна | 192 752 | |
| mcp-pandoc | нет | не нужна | 584 | MCP-сервер на базе pandoc |
| WebArchiveExtractor — распаковка файлов webarchive | нет | 346 | скилл для Claude Code на macOS |
Из блога
Коротко о README
README объясняет выбор Markdown: модели хорошо его понимают, а разметка экономит токены. Описаны установка через pip с выбором зависимостей по форматам, работа из командной строки и Python, сторонние плагины и плагин OCR, интеграции с Azure Document Intelligence и Content Understanding. Отдельный README пакета markitdown-mcp дает запуск через stdio, HTTP и Docker и конфигурацию для Claude Desktop. Лицензия MIT.