Skip to main content
Glama

MCP-сервер Markdownify

логотип markdownify mcp

Markdownify — это сервер протокола контекста модели (MCP), который преобразует различные типы файлов и веб-контент в формат Markdown. Он предоставляет набор инструментов для трансформации PDF, изображений, аудиофайлов, веб-страниц и многого другого в легко читаемый и удобный для обмена текст в формате Markdown.

Возможности

  • Преобразование различных типов файлов в Markdown:

    • PDF

    • Изображения

    • Аудио (с транскрибацией)

    • DOCX

    • XLSX

    • PPTX

  • Преобразование веб-контента в Markdown:

    • Транскрипты видео YouTube

    • Результаты поиска Bing

    • Обычные веб-страницы

  • Получение существующих файлов Markdown

Related MCP server: Markdownify MCP Server

Начало работы

  1. Клонируйте этот репозиторий

  2. Установите зависимости:

    bun install

    Шаг preinstall создает виртуальное окружение Python в .venv и устанавливает markitdown[all].

  3. Соберите проект:

    bun run build
  4. Запустите сервер:

    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"
      ]
    }
  }
}

Переменные окружения

Все пути по умолчанию имеют разумные значения; переопределяйте их только в том случае, если значения по умолчанию не подходят для вашей схемы установки.

Переменная

По умолчанию

Назначение

MARKITDOWN_PATH

<project>/.venv/bin/markitdown, затем markitdown в PATH

Абсолютный путь к исполняемому файлу markitdown. Установите его, если вы установили markitdown в системе (например, pipx install "markitdown[pdf]") вместо использования встроенного venv.

REPOMIX_PATH

<project>/node_modules/.bin/repomix, затем repomix в PATH

Абсолютный путь к исполняемому файлу repomix, используемому git-repo-to-markdown.

MD_ALLOWED_PATHS

не задано (не ограничено)

Список каталогов, разделенных разделителем путей (: в POSIX, ; в Windows), к которым серверу разрешен доступ. Если задано, все инструменты ввода файлов (pdf-to-markdown, get-markdown-file и т. д.) отклоняют пути за пределами этих каталогов.

MD_SHARE_DIR

не задано

Устаревший псевдоним для MD_ALLOWED_PATHS (один каталог). По-прежнему поддерживается для обратной совместимости.

Использование с 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 в Markdown

  • pdf-to-markdown: Преобразование PDF-файлов в Markdown

  • bing-search-to-markdown: Преобразование результатов поиска Bing в Markdown

  • webpage-to-markdown: Преобразование веб-страниц в Markdown

  • image-to-markdown: Преобразование изображений в Markdown с метаданными

  • audio-to-markdown: Преобразование аудиофайлов в Markdown с транскрибацией

  • docx-to-markdown: Преобразование DOCX-файлов в Markdown

  • xlsx-to-markdown: Преобразование XLSX-файлов в Markdown

  • pptx-to-markdown: Преобразование PPTX-файлов в Markdown

  • get-markdown-file: Получение существующего файла Markdown. Расширение файла должно заканчиваться на: *.md, *.markdown.

    ДОПОЛНИТЕЛЬНО: установите MD_ALLOWED_PATHS для ограничения каждого инструмента ввода файлов списком каталогов, например MD_ALLOWED_PATHS=/data/in:/data/out bun start.

Вклад в проект

Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Available Tools

10 tools
audio-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

    A3.6/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessMostly unanswered

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts 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 npm
      14
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts 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.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts 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