Markdownify MCP Server
MCP-сервер Markdownify

Markdownify — это сервер протокола контекста модели (MCP), который преобразует различные типы файлов и веб-контент в формат Markdown. Он предоставляет набор инструментов для трансформации PDF, изображений, аудиофайлов, веб-страниц и многого другого в легко читаемый и удобный для обмена текст в формате Markdown.
Возможности
Преобразование различных типов файлов в Markdown:
PDF
Изображения
Аудио (с транскрибацией)
DOCX
XLSX
PPTX
Преобразование веб-контента в Markdown:
Транскрипты видео YouTube
Результаты поиска Bing
Обычные веб-страницы
Получение существующих файлов Markdown
Related MCP server: Markdownify MCP Server
Начало работы
Клонируйте этот репозиторий
Установите зависимости:
bun installШаг
preinstallсоздает виртуальное окружение Python в.venvи устанавливаетmarkitdown[all].Соберите проект:
bun run buildЗапустите сервер:
bun start
Разработка
Используйте
bun run devдля запуска компилятора TypeScript в режиме отслеживания измененийИзменяйте
src/server.tsдля настройки поведения сервераДобавляйте или изменяйте инструменты в
src/tools.ts
Использование с настольным приложением
Чтобы интегрировать этот сервер с настольным приложением, добавьте следующее в конфигурацию сервера вашего приложения:
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
]
}
}
}Переменные окружения
Все пути по умолчанию имеют разумные значения; переопределяйте их только в том случае, если значения по умолчанию не подходят для вашей схемы установки.
Переменная | По умолчанию | Назначение |
|
| Абсолютный путь к исполняемому файлу |
|
| Абсолютный путь к исполняемому файлу |
| не задано (не ограничено) | Список каталогов, разделенных разделителем путей ( |
| не задано | Устаревший псевдоним для |
Использование с Docker
Сборка и запуск:
docker build -t markdownify-mcp .
docker run --rm -i \
-v "$HOME/Documents:/data:ro" \
-e MD_ALLOWED_PATHS=/data \
markdownify-mcpПримечания для каталога Docker MCP (mcp/markdownify):
Монтируйте любые хост-каталоги, которые вы хотите, чтобы сервер читал, в контейнер, а затем передавайте контейнерные пути инструментам (например,
/data/foo.pdf, а не/Users/you/Documents/foo.pdf).Установите
MD_ALLOWED_PATHSв список смонтированных каталогов, разделенных двоеточием, чтобы сервер обеспечивал границу чтения, соответствующую bind-монту.Опубликованный образ Docker устанавливает только
markitdown[pdf]— транскрибация аудио и OCR изображений (audio-to-markdown,image-to-markdown) требуют дополнений[all]и не будут работать в slim-образе. Используйте локальную установку (bun install) для полного набора функций.
Доступные инструменты
youtube-to-markdown: Преобразование видео YouTube в Markdownpdf-to-markdown: Преобразование PDF-файлов в Markdownbing-search-to-markdown: Преобразование результатов поиска Bing в Markdownwebpage-to-markdown: Преобразование веб-страниц в Markdownimage-to-markdown: Преобразование изображений в Markdown с метаданнымиaudio-to-markdown: Преобразование аудиофайлов в Markdown с транскрибациейdocx-to-markdown: Преобразование DOCX-файлов в Markdownxlsx-to-markdown: Преобразование XLSX-файлов в Markdownpptx-to-markdown: Преобразование PPTX-файлов в Markdownget-markdown-file: Получение существующего файла Markdown. Расширение файла должно заканчиваться на: *.md, *.markdown.ДОПОЛНИТЕЛЬНО: установите
MD_ALLOWED_PATHSдля ограничения каждого инструмента ввода файлов списком каталогов, напримерMD_ALLOWED_PATHS=/data/in:/data/out bun start.
Вклад в проект
Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.
Лицензия
Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.
Available Tools
10 toolsaudio-to-markdownC
Convert an audio file to markdown, including transcription if possible
Inputs: filepath (required).
bing-search-to-markdownC
Convert a Bing search results page to markdown
Inputs: url (required).
docx-to-markdownC
Convert a DOCX file to markdown
Inputs: filepath (required).
get-markdown-fileC
Get a markdown file by absolute file path
Inputs: filepath (required).
image-to-markdownC
Convert an image to markdown, including metadata and description
Inputs: filepath (required).
pdf-to-markdownC
Convert a PDF file to markdown
Inputs: filepath (required).
pptx-to-markdownC
Convert a PPTX file to markdown
Inputs: filepath (required).
webpage-to-markdownC
Convert a webpage to markdown
Inputs: url (required).
xlsx-to-markdownC
Convert an XLSX file to markdown
Inputs: filepath (required).
youtube-to-markdownC
Convert a YouTube video to markdown, including transcript if available
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose focused on converting a specific input format (audio, Bing search, DOCX, etc.) to markdown. The descriptions specify unique source types, making it impossible to confuse which tool to use for a given conversion task.
All tools follow a consistent pattern of 'source-to-markdown' (e.g., audio-to-markdown, docx-to-markdown). This uniform naming convention makes it easy to predict tool names and understand their functions at a glance.
With 10 tools, the server covers a comprehensive range of common input formats (audio, documents, web content, spreadsheets, presentations, etc.) for markdown conversion. This count is well-scoped for the domain, providing thorough coverage without being overwhelming.
The tool set offers complete coverage for converting various media and file types to markdown, including audio, images, documents, webpages, and videos. There are no obvious gaps; each tool handles a distinct input format, ensuring agents can convert any supported source without dead ends.
Maintenance
Related MCP Connectors
Convert PDF, Word, Excel, PowerPoint, e-mails and web pages to clean Markdown for LLMs.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Documents to Markdown/PDF, OCR, video and audio transcripts, TTS, screenshots, domains, frames.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConverts various file types (documents, images, audio, web content) to markdown format without requiring Docker, supporting PDF, Word, Excel, PowerPoint, images, audio files, web URLs, and more.397 npm14MIT
- AlicenseAqualityDmaintenanceConverts various file types (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube videos, web pages, Bing search results) into Markdown format for easy reading and sharing.10MIT
- AlicenseNot gradedqualityDmaintenanceConverts documents, webpages, and media files into markdown for AI assistants using Microsoft's MarkItDown and Crawl4AI. It enables tools to read PDFs, Office files, and JavaScript-rendered websites with support for OCR and image extraction.3MIT
- AlicenseNot gradedqualityDmaintenanceConverts files (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube transcripts, Bing search, general pages) to Markdown via the Model Context Protocol.Apache 2.0