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

Особенности

• Преобразование нескольких типов файлов в Markdown:
• PDF
• Изображения
• Аудио (с транскрипцией)
• DOCX
• XLSX
• PPTX
• Конвертация веб-контента в Markdown:
• Расшифровки видео на YouTube
• Результаты поиска в Bing
• Общие веб-страницы
• Получить существующие файлы Markdown

Начало

1. Клонировать это хранилище
2. Установка зависимостей:

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

3. Постройте проект:

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

Развитие

• Используйте bun run dev для запуска компилятора TypeScript в режиме наблюдения
• Модифицировать src/server.ts для настройки поведения сервера
• Добавлять или модифицировать инструменты в src/tools.ts

Использование с десктопным приложением

Чтобы интегрировать этот сервер с десктопным приложением, добавьте в конфигурацию сервера вашего приложения:

Переменные среды

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

Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.

Features

• Convert multiple file types to Markdown:
  • PDF
  • Images
  • Audio (with transcription)
  • DOCX
  • XLSX
  • PPTX
• Convert web content to Markdown:
  • YouTube video transcripts
  • Bing search results
  • General web pages
• Retrieve existing Markdown files

Getting Started

1. Clone this repository

2. Install dependencies:

   bun install
   

   The preinstall step creates a Python virtual environment at .venv and installs markitdown[all].

3. Build the project:

   bun run build
   

4. Start the server:

   bun start
   

Development

• Use bun run dev to start the TypeScript compiler in watch mode
• Modify src/server.ts to customize server behavior
• Add or modify tools in src/tools.ts

Usage with Desktop App

To integrate this server with a desktop app, add the following to your app’s server configuration:

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Environment variables

All paths default to sensible values; override only when the defaults don’t fit your install layout.

Usage with Docker

Build and run:

docker build -t markdownify-mcp .
docker run --rm -i \
  -v "$HOME/Documents:/data:ro" \
  -e MD_ALLOWED_PATHS=/data \
  markdownify-mcp

Notes for the Docker MCP catalog (mcp/markdownify):

• Mount any host directories you want the server to read into the container, then pass the container paths to the tools (e.g. /data/foo.pdf, not /Users/you/Documents/foo.pdf).