# Markitdown

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

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: microsoft
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/microsoft/markitdown/tree/HEAD/packages/markitdown-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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`, и это разумная граница.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

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

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

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

## Похожие
- [pdf-to-markdown](https://affpapa.org/nevibecode/skills/pdf-to-markdown.md) — скилл · 870 установок
- [mcp-document-converter](https://affpapa.org/nevibecode/mcp/mcp-document-converter.md) — MCP-сервер · ★ 12 у репозитория
- [markitdown-skill](https://affpapa.org/nevibecode/skills/markitdown-skill.md) — скилл · ★ 108 у репозитория
- [doc-to-markdown](https://affpapa.org/nevibecode/skills/doc-to-markdown.md) — скилл · 945 установок
- [pandoc](https://affpapa.org/nevibecode/skills/pandoc.md) — скилл · 496 установок
- [document-converter-suite](https://affpapa.org/nevibecode/skills/document-converter-suite.md) — скилл · 495 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
