MarkItDown MCP

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

Пакет markitdown-mcp из репозитория microsoft/markitdown оборачивает библиотеку MarkItDown в MCP-сервер. Он даёт агенту один инструмент, convert_to_markdown(uri), где uri может быть адресом веб-страницы, локального файла (схема file:) или данными в схеме data:. На выходе модель получает Markdown, то есть чистый текст с заголовками и таблицами, который удобно читать и цитировать. Сервер умеет работать по STDIO (по умолчанию), а также по Streamable HTTP и SSE.

Когда использовать

Подключайте сервер, если агенту нужно быстро прочитать содержимое документа или страницы и не хочется писать для этого отдельный код: превратить в текст файл из рабочей папки, разобрать скачанный документ, получить Markdown-версию веб-страницы для дальнейшего пересказа или сравнения. Это самый простой способ дать Claude Desktop «читалку» для файлов, особенно в связке с запуском в Docker и смонтированной папкой.

Если вам нужно не читать, а создавать и править документы Word, Excel или PowerPoint, возьмите другие серверы или навыки из этой же категории: MarkItDown только конвертирует в Markdown.

Для HTTP-режима README указывает для проверки пути /mcp (Streamable HTTP) и /sse (SSE) на локальном порту 3001. Такой запуск задуман как прямая замена STDIO там, где она удобнее, а не как способ открыть сервер для других компьютеров.

Ограничения и безопасность

В README первым пунктом стоит предупреждение: пакет рассчитан на локальное использование с доверенными локальными агентами. В режимах HTTP и SSE сервер по умолчанию слушает только localhost, и привязывать его к другим интерфейсам не следует, пока вы не разобрались в последствиях.

Аутентификации у сервера нет, и работает он с правами запустившего его пользователя. Поэтому convert_to_markdown способен прочитать любой файл, доступный этому пользователю, и любые данные из сети, к которым есть доступ. Если нужна дополнительная защита, запускайте сервер в изолированной среде, например в контейнере или виртуальной машине, и ограничивайте права. Для Claude Desktop README рекомендует Docker-образ; чтобы дать доступ к локальным файлам, папку монтируют в контейнер.

Установка и запуск

Пакет ставится через pip:

pip install markitdown-mcp

Запуск по STDIO (по умолчанию):

markitdown-mcp

Запуск по Streamable HTTP и SSE:

markitdown-mcp --http --host 127.0.0.1 --port 3001

Docker

Соберите образ с помощью Dockerfile из репозитория и запустите его:

docker build -t markitdown-mcp:latest .
docker run -it --rm markitdown-mcp:latest

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

docker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest

Claude Desktop

README рекомендует Docker-образ. Добавьте запись в claude_desktop_config.json:

{
  "mcpServers": {
    "markitdown": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "markitdown-mcp:latest"
      ]
    }
  }
}

Если нужно смонтировать каталог:

{
  "mcpServers": {
    "markitdown": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/home/user/data:/workdir",
        "markitdown-mcp:latest"
      ]
    }
  }
}

Проверка

Работу сервера можно проверить в MCP Inspector:

npx @modelcontextprotocol/inspector