mcp-document-converter — MCP-сервер для Claude Code: что делает
Конвертирует документы между форматами Markdown, HTML, DOCX, PDF и простым текстом через протокол MCP. Пригодится, когда нужно скормить ассистенту разнородные файлы проекта.
claude mcp add mcp-document-converter -- uvx mcp-document-converterЧто делает mcp-document-converter
Сервер добавляет агенту инструмент convert_document для работы с пятью форматами: Markdown, HTML, DOCX, PDF и неразмеченным текстом. Между ними поддерживаются двусторонние преобразования, что даёт двадцать пять возможных комбинаций. Архитектура построена вокруг единого промежуточного дерева DocumentIR, поэтому при экспорте сохраняются метаданные, заголовки и базовая структура файла.
Инструмент принимает путь к исходнику source_path, целевой формат target_format и необязательные параметры options. Через них можно передать файлы CSS для оформления или шаблон страницы. Для генерации файлов PDF сервер запускает библиотеку WeasyPrint.
Для запуска требуется окружение Python версии 3.10+. Без установленной утилиты uvx или системных библиотек рендерера WeasyPrint сервер выдаст ошибку при старте.
Какие задачи решает
- перевести DOCX или PDF в чистый Markdown для контекста модели
- сгенерировать стилизованный PDF из Markdown или HTML
- конвертировать HTML-страницы в офисные документы DOCX
- сохранить метаданные и структуру заголовков при смене формата
Примеры запросов агенту
- Сконвертируй документацию из
spec.docxв форматspec.md - Переведи файл
report.mdвreport.pdfсо стилями изcustom.css - Преобразуй
overview.htmlв обычный текст без тегов
Как установить mcp-document-converter
Командой платформы
claude mcp add mcp-document-converter -- uvx mcp-document-converteruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-document-converter <команда>
Командой платформы
codex mcp add mcp-document-converter -- uvx mcp-document-converteruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-document-converter <команда>
Файл настроек
{
"mcpServers": {
"mcp-document-converter": {
"command": "uvx",
"args": [
"mcp-document-converter"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-document-converter <команда>
Файл настроек
{
"servers": {
"mcp-document-converter": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-document-converter"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-document-converter <команда>
Командой платформы
gemini mcp add mcp-document-converter uvx mcp-document-converteruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-document-converter <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-document-converter
Как установить mcp-document-converter в Claude Code?
Выполните команду claude mcp add mcp-document-converter -- uvx mcp-document-converter. Для запуска потребуется установленная в системе утилита uv.
Какие форматы файлов поддерживает сервер?
Сервер работает с пятью форматами: Markdown, HTML, DOCX, PDF и обычный текст. Преобразовывать документы можно между любой парой этих расширений в обоих направлениях.
Что нужно для генерации PDF-файлов?
Выгрузка в PDF опирается на движок WeasyPrint и требует Python версии 3.10+. При вызове инструмента можно задать собственную таблицу стилей CSS через блок параметров options.
