Skip to main content
Glama

Markdownify MCP-Server

markdownify mcp logo

Markdownify ist ein Model Context Protocol (MCP)-Server, der verschiedene Dateitypen und Webinhalte in das Markdown-Format konvertiert. Er bietet eine Reihe von Tools, um PDFs, Bilder, Audiodateien, Webseiten und mehr in leicht lesbaren und teilbaren Markdown-Text umzuwandeln.

Funktionen

  • Konvertierung verschiedener Dateitypen in Markdown:

    • PDF

    • Bilder

    • Audio (mit Transkription)

    • DOCX

    • XLSX

    • PPTX

  • Konvertierung von Webinhalten in Markdown:

    • YouTube-Videotranskripte

    • Bing-Suchergebnisse

    • Allgemeine Webseiten

  • Abrufen vorhandener Markdown-Dateien

Related MCP server: Markdownify MCP Server

Erste Schritte

  1. Repository klonen

  2. Abhängigkeiten installieren:

    bun install

    Der preinstall-Schritt erstellt eine Python-virtuelle Umgebung unter .venv und installiert markitdown[all].

  3. Projekt bauen:

    bun run build
  4. Server starten:

    bun start

Entwicklung

  • Verwende bun run dev, um den TypeScript-Compiler im Watch-Modus zu starten

  • Ändere src/server.ts, um das Serververhalten anzupassen

  • Füge Tools in src/tools.ts hinzu oder ändere sie

Verwendung mit Desktop-App

Um diesen Server in eine Desktop-App zu integrieren, füge Folgendes zur Serverkonfiguration deiner App hinzu:

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

Umgebungsvariablen

Alle Pfade sind standardmäßig auf sinnvolle Werte eingestellt; überschreibe sie nur, wenn die Standardwerte nicht zu deinem Installationslayout passen.

Variable

Standardwert

Zweck

MARKITDOWN_PATH

<project>/.venv/bin/markitdown, dann markitdown im PATH

Absoluter Pfad zur markitdown-Ausführungsdatei. Setze dies, wenn du markitdown systemweit installiert hast (z. B. pipx install "markitdown[pdf]"), anstatt die gebündelte venv zu verwenden.

REPOMIX_PATH

<project>/node_modules/.bin/repomix, dann repomix im PATH

Absoluter Pfad zur repomix-Ausführungsdatei, die von git-repo-to-markdown verwendet wird.

MD_ALLOWED_PATHS

nicht gesetzt (uneingeschränkt)

Durch Pfadtrennzeichen getrennte Liste (: unter POSIX, ; unter Windows) von Verzeichnissen, die der Server lesen darf. Wenn gesetzt, lehnen alle Dateieingabe-Tools (pdf-to-markdown, get-markdown-file usw.) Pfade außerhalb dieser Verzeichnisse ab.

MD_SHARE_DIR

nicht gesetzt

Veralteter Alias für MD_ALLOWED_PATHS (einzelnes Verzeichnis). Wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt.

Verwendung mit Docker

Bauen und Ausführen:

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

Hinweise für den Docker MCP-Katalog (mcp/markdownify):

  • Hänge alle Host-Verzeichnisse, die der Server lesen soll, in den Container ein und übergebe dann die Container-Pfade an die Tools (z. B. /data/foo.pdf, nicht /Users/you/Documents/foo.pdf).

  • Setze MD_ALLOWED_PATHS auf die durch Doppelpunkte getrennte Liste der eingehängten Verzeichnisse, damit der Server eine Lesebegrenzung erzwingt, die dem Bind-Mount entspricht.

  • Das veröffentlichte Docker-Image installiert nur markitdown[pdf] — Audiotranskription und Bild-OCR (audio-to-markdown, image-to-markdown) erfordern die [all]-Extras und schlagen im Slim-Image fehl. Verwende die lokale Installation (bun install) für den vollen Funktionsumfang.

Verfügbare Tools

  • youtube-to-markdown: Konvertiert YouTube-Videos in Markdown

  • pdf-to-markdown: Konvertiert PDF-Dateien in Markdown

  • bing-search-to-markdown: Konvertiert Bing-Suchergebnisse in Markdown

  • webpage-to-markdown: Konvertiert Webseiten in Markdown

  • image-to-markdown: Konvertiert Bilder in Markdown mit Metadaten

  • audio-to-markdown: Konvertiert Audiodateien in Markdown mit Transkription

  • docx-to-markdown: Konvertiert DOCX-Dateien in Markdown

  • xlsx-to-markdown: Konvertiert XLSX-Dateien in Markdown

  • pptx-to-markdown: Konvertiert PPTX-Dateien in Markdown

  • get-markdown-file: Ruft eine vorhandene Markdown-Datei ab. Die Dateiendung muss auf *.md oder *.markdown enden.

    OPTIONAL: Setze MD_ALLOWED_PATHS, um jedes Dateieingabe-Tool auf eine Liste von Verzeichnissen zu beschränken, z. B. MD_ALLOWED_PATHS=/data/in:/data/out bun start.

Mitwirken

Beiträge sind willkommen! Bitte reiche gerne einen Pull Request ein.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE-Datei für Details.

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
    ResponsivenessOutdated data

    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