| name | file-converter |
| description | Конвертация файлов локально, без API-ключей: формат→формат через MCP file-converter (Word↔PDF, изображения, Excel→CSV) и ЧТО УГОДНО→Markdown через markitdown (PDF/Office/HTML/EPub/ZIP, OCR картинок, аудио, YouTube-URL). Триггеры: «word в pdf», «вытащи текст из pdf/docx», «файл для модели». НЕ: pixel-perfect PDF-вёрстка→pdf; Q&A по папке документов→research-docs; сложные сканы→ocr-restore. |
File Converter MCP Server Skill
Overview
Локальный MCP сервер для конвертации файлов. Без API ключа!
Installation
Уже добавлен в mcp.json:
{
"file-converter": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/<author>/file-converter-mcp",
"file-converter-mcp"
]
}
}
Зависимости (устанавливаются автоматически):
pip install mcp docx2pdf pdf2docx pillow pandas pdfkit markdown
Features
Конвертация документов:
| Из | В | Tool |
|---|
| Word (.docx) | PDF | docx_to_pdf |
| PDF | Word (.docx) | pdf_to_docx |
| Excel (.xlsx) | CSV | excel_to_csv |
| HTML | PDF | html_to_pdf |
| Markdown | PDF | markdown_to_pdf |
Конвертация изображений:
| Из | В | Tool |
|---|
| PNG | JPG, WebP, etc. | convert_image |
| JPG | PNG, WebP, etc. | convert_image |
| WebP | PNG, JPG, etc. | convert_image |
| Любой формат | Любой формат | convert_image |
MCP Tools
После установки доступны:
| Tool | Описание |
|---|
docx_to_pdf | Word → PDF |
pdf_to_docx | PDF → Word |
excel_to_csv | Excel → CSV |
html_to_pdf | HTML → PDF |
markdown_to_pdf | Markdown → PDF |
convert_image | Конвертация изображений |
Usage
Через Claude Code (MCP):
# Конвертировать Word в PDF
Конвертируй document.docx в PDF
# Конвертировать PDF в Word
Преобразуй report.pdf в редактируемый Word документ
# Конвертировать изображение
Конвертируй image.png в WebP формат
# Excel в CSV
Преобразуй data.xlsx в CSV
Input modes:
- File path - путь к файлу на диске
- Base64 - закодированный контент файла
Advantages
| Feature | file-converter-mcp | PDF.co |
|---|
| API Key | Не нужен | Нужен |
| Стоимость | Бесплатно | Платно |
| Offline | Да | Нет |
| Приватность | Локально | Cloud |
| Скорость | Быстро | Зависит от сети |
When to Use
| Задача | Используй |
|---|
| Word ↔ PDF | file-converter |
| Image conversion | file-converter |
| Excel → CSV | file-converter |
| HTML/MD → PDF | file-converter |
| ЧТО УГОДНО → Markdown для LLM | markitdown (см. ниже) |
markitdown — «всё → Markdown» для LLM (установлен локально)
Установлен и проверен: markitdown 0.1.5 со всеми экстрами (pdf/docx/xlsx/pptx/youtube/audio). MIT, работает offline, файлы не уходят в облако. Это НЕ MCP-сервер (его у markitdown нет) — CLI + Python API.
Когда: нужно скормить модели содержимое файла/страницы/видео — PDF, Word, Excel, PowerPoint, HTML, CSV/JSON/XML, EPub, ZIP (рекурсивно), картинки (OCR + EXIF), аудио (транскрипция), YouTube-URL (транскрипт). Оптимизирован под чтение LLM, не под человеческую вёрстку.
markitdown doc.pdf > doc.md
cat report.docx | markitdown
markitdown "https://youtu.be/VIDEO_ID"
from markitdown import MarkItDown
md = MarkItDown()
print(md.convert("table.xlsx").text_content)
Гочи:
- Выход — под LLM, а не «красивый документ»: сложная вёрстка/колонки могут упроститься. Нужен pixel-fidelity →
file-converter / pdf.
- Untrusted-файлы: предпочитай
convert_local() вместо общего convert() (не ходит в сеть за ресурсами).
- Скан-PDF без текстового слоя → OCR-качество ограничено; для сложных сканов бери
ocr-restore / research-docs (PageIndex).
- Не путать со сравнением ниже:
file-converter — про формат→формат (Word↔PDF, image→image), markitdown — про что угодно→текст для модели.
Tips
- Локальная обработка - файлы не уходят в облако
- Без лимитов - конвертируй сколько нужно
- Быстро - нет сетевых задержек
- Комбинируй:
markitdown (см. секцию выше) вытаскивает текст/структуру для модели, file-converter — меняет формат файла
Source
GitHub: /file-converter-mcp
