К основному содержанию
MCP-сервер CX Codex

Markitdown — MCP-сервер для Claude Code: что делает и как установить

Локальный MCP-сервер над MarkItDown с одним инструментом: convert_to_markdown превращает файл или ссылку в markdown, который агент читает напрямую.

лицензия не указана обновлён 2026-10-29

Открыть на GitHub

Что делает Markitdown

Пакет markitdown-mcp поднимает MCP-сервер над библиотекой MarkItDown. Агенту он отдаёт один инструмент — convert_to_markdown(uri). В uri годится http:, https:, file: или data:, а возвращается markdown, который модель читает без бинарного мусора.

Транспорт по умолчанию — STDIO, запуск одной командой markitdown-mcp. Для Streamable HTTP или SSE добавляются флаги: markitdown-mcp --http --host 127.0.0.1 --port 3001. В Docker образ собирается из Dockerfile в репозитории, но локальные файлы видны только после монтирования каталога, например -v /home/user/data:/workdir.

Аутентификации нет, сервер работает с правами запустившего пользователя. Значит, convert_to_markdown прочитает любой файл, до которого эти права дотягиваются, и сходит в сеть от того же имени. Поэтому авторы просят не вешать его на внешние интерфейсы: по умолчанию он слушает localhost, и это разумная граница.

Какие задачи решает

  • сконвертировать локальный файл в markdown по file:-uri
  • вытащить текст страницы по https:-адресу без копипаста
  • подключить конвертацию к Claude Desktop через Docker-образ
  • отладить вызов инструмента в MCP Inspector
  • передать содержимое через data:-uri без временного файла

Примеры запросов агенту

  • Сконвертируй file:///workdir/notes.txt в markdown и разбей на разделы.
  • Вызови convert_to_markdown для этого адреса и сохрани результат в notes.md.
  • Прочитай документ за этим data:-uri и выпиши все даты.

Как установить Markitdown

Установка

Команды запуска нет в реестре MCP — смотрите README репозитория

По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Вопросы о Markitdown

Как установить Markitdown в Claude Code?

Поставьте пакет командой pip install markitdown-mcp, затем запустите сервер командой markitdown-mcp — по умолчанию он работает по STDIO.

Что делает Markitdown?

Даёт агенту один инструмент convert_to_markdown(uri), который принимает http:, https:, file: или data:-ссылку и возвращает markdown.

Есть ли в сервере аутентификация?

Нет. Он работает с правами пользователя, который его запустил, поэтому читает всё, что тому доступно, и по умолчанию слушает только localhost.

Похожие MCP-серверы

Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →
pdf-to-markdown PSPDFKit-labs Скилл pdf-to-markdown для Claude Code и Codex. Превращает PDF в структурированный Markdown: заголовки, таблицы, списки и порядок чтения сохраняются. Извлекает текст для анализа или передачи агенту. CX Codex +1 870установок mcp-document-converter xt765 MCP-сервер mcp-document-converter для Claude Code, Codex и Cursor, который конвертирует документы между пятью форматами: Markdown, HTML, DOCX, PDF и Text. CX Codex +1 ★ 12звёзд репо markitdown-skill cjh-solver Скилл markitdown-skill для Claude Code переводит документы и веб-страницы в Markdown через CLI markitdown. Выполняет OCR изображений, транскрибирует аудио и пакетно обрабатывает папки. CX Codex +1 ★ 108звёзд репо doc-to-markdown daymade Скилл doc-to-markdown для Claude Code и Codex конвертирует DOCX, PDF, PPTX и сохранённый HTML в Markdown с автоматической зачисткой разметки. Включается при запросах на парсинг документов. CX Codex +1 945установок pandoc plinde Гоняет документы между Markdown, DOCX, PDF, HTML и LaTeX через pandoc. Отдаёт текст в Word, собирает PDF. CX Codex +1 496установок document-converter-suite dkyazzentwatwa Скилл document-converter-suite для Claude Code и других платформ: конвертирует PDF, Office-файлы, markdown, HTML и таблицы в редактируемые форматы. Вытаскивает данные из документа или собирает его заново. CX Codex +1 495установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой