Microsoft MarkItDown·microsoft
Microsoft MarkItDown MCP — подключение и инструкция
MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.
Что умеет этот сервер
MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.
Официальный пакет markitdown-mcp предоставляет convert_to_markdown(uri).
Выбери небольшой тестовый файл и вызови конвертацию его URI.
Задача для знакомства
Через MarkItDown MCP преобразуй мой тестовый файл в Markdown и отметь места, где структура могла потеряться. Исходный документ не меняй.
Уточнить результат
Сравни результат с исходником: порядок разделов, числа и табличные связи. В Docker локальная папка должна быть смонтирована, а URI использовать путь внутри контейнера.
Как подключить
Выберите подходящий способПодключить Microsoft MarkItDown MCP
Установи pip install markitdown-mcp и добавь command markitdown-mcp в MCP-клиент. Для HTTP есть отдельный запуск с --http, host и port; сервер рассчитан на локальное доверенное использование и по умолчанию не публикуется наружу.
Что понадобится
- Python/pip, пакет markitdown-mcp и доступ к выбранному файлу. Поддержка отдельных форматов зависит от зависимостей конвертера.
- 01
Подготовь окружение
Python/pip, пакет markitdown-mcp и доступ к выбранному файлу. Поддержка отдельных форматов зависит от зависимостей конвертера.
- 02
Установи и настрой
Установи pip install markitdown-mcp и добавь command markitdown-mcp в MCP-клиент. Для HTTP есть отдельный запуск с --http, host и port; сервер рассчитан на локальное доверенное использование и по умолчанию не публикуется наружу.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Команда подключения из документации
pip install markitdown-mcpПервый запрос — пример для чата агента
Через MarkItDown MCP преобразуй мой тестовый файл в Markdown и отметь места, где структура могла потеряться. Исходный документ не меняй.Как проверить
Сравни результат с исходником: порядок разделов, числа и табличные связи. В Docker локальная папка должна быть смонтирована, а URI использовать путь внутри контейнера.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Microsoft MarkItDown
MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.
Официальный пакет markitdown-mcp предоставляет convert_to_markdown(uri). Это MCP-обёртка конвертера, не весь MarkItDown CLI и не сервер редактирования исходного офисного документа.
Что подготовить перед подключением
Python/pip, пакет markitdown-mcp и доступ к выбранному файлу. Поддержка отдельных форматов зависит от зависимостей конвертера.
Как установить и подключить
Установи pip install markitdown-mcp и добавь command markitdown-mcp в MCP-клиент. Для HTTP есть отдельный запуск с --http, host и port; сервер рассчитан на локальное доверенное использование и по умолчанию не публикуется наружу.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Выбери небольшой тестовый файл и вызови конвертацию его URI. Проверь структуру, заголовки и таблицы, затем передай полученный Markdown в задачу анализа.
Как проверить результат и решить проблемы
Сравни результат с исходником: порядок разделов, числа и табличные связи. В Docker локальная папка должна быть смонтирована, а URI использовать путь внутри контейнера.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Markdown не сохраняет всё оформление и интерактивность исходного документа. Сервис работает с правами процесса и не имеет встроенной публичной авторизации; доступные ему файлы требуют осмысленного ограничения.
Исходники и документация
Репозиторий: microsoft/markitdown. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.