Microsoft MarkItDown·microsoft

Microsoft MarkItDown MCP — подключение и инструкция

MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.

Файлы и документыЛокальноБез ключа

Что умеет этот сервер

01

MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.

02

Официальный пакет markitdown-mcp предоставляет convert_to_markdown(uri).

03

Выбери небольшой тестовый файл и вызови конвертацию его 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 и доступ к выбранному файлу. Поддержка отдельных форматов зависит от зависимостей конвертера.
  1. 01

    Подготовь окружение

    Python/pip, пакет markitdown-mcp и доступ к выбранному файлу. Поддержка отдельных форматов зависит от зависимостей конвертера.

  2. 02

    Установи и настрой

    Установи pip install markitdown-mcp и добавь command markitdown-mcp в MCP-клиент. Для HTTP есть отдельный запуск с --http, host и port; сервер рассчитан на локальное доверенное использование и по умолчанию не публикуется наружу.

  3. 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-серверов Нейролюба.

Вопросы о Microsoft MarkItDown

MarkItDown MCP преобразует доступные документы и веб-материалы в Markdown, удобный для дальнейшего анализа ИИ-агентом.
Вернуться в библиотеку