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 - UTF-8 Enhanced

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.

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.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• audio-to-markdownB
• bing-search-to-markdownC
• docx-to-markdownC
• get-markdown-fileC
• image-to-markdownB
• pdf-to-markdownC
• pptx-to-markdownC
• webpage-to-markdownC