Markdownify MCP Server
Markdownify MCP-Server

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
Repository klonen
Abhängigkeiten installieren:
bun installDer
preinstall-Schritt erstellt eine Python-virtuelle Umgebung unter.venvund installiertmarkitdown[all].Projekt bauen:
bun run buildServer starten:
bun start
Entwicklung
Verwende
bun run dev, um den TypeScript-Compiler im Watch-Modus zu startenÄndere
src/server.ts, um das Serververhalten anzupassenFüge Tools in
src/tools.tshinzu 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 |
|
| Absoluter Pfad zur |
|
| Absoluter Pfad zur |
| nicht gesetzt (uneingeschränkt) | Durch Pfadtrennzeichen getrennte Liste ( |
| nicht gesetzt | Veralteter Alias für |
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-mcpHinweise 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_PATHSauf 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 Markdownpdf-to-markdown: Konvertiert PDF-Dateien in Markdownbing-search-to-markdown: Konvertiert Bing-Suchergebnisse in Markdownwebpage-to-markdown: Konvertiert Webseiten in Markdownimage-to-markdown: Konvertiert Bilder in Markdown mit Metadatenaudio-to-markdown: Konvertiert Audiodateien in Markdown mit Transkriptiondocx-to-markdown: Konvertiert DOCX-Dateien in Markdownxlsx-to-markdown: Konvertiert XLSX-Dateien in Markdownpptx-to-markdown: Konvertiert PPTX-Dateien in Markdownget-markdown-file: Ruft eine vorhandene Markdown-Datei ab. Die Dateiendung muss auf*.mdoder*.markdownenden.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 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