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.