Was ist MarkItDown MCP?
MarkItDown ist Microsofts Python-Tool, das Dateien und Office-Dokumente in Markdown umwandelt; das Haupt-Repository hat rund 191.700 GitHub-Sterne. Das Paket markitdown-mcp verpackt es als MCP-Server, gebaut vom AutoGen-Team.
Es stellt genau ein Tool bereit, convert_to_markdown(uri), das URIs mit http:, https:, file: oder data: annimmt. Standardmäßig läuft es über stdio, mit dem Flag --http über Streamable HTTP und SSE, gebunden an localhost. Installiert wird es mit pip install markitdown-mcp; für Claude Desktop empfiehlt die README, das Docker-Image aus dem Dockerfile des Repositorys zu bauen und einen Ordner für lokale Dateien einzuhängen. Im offiziellen MCP-Registry ist es nicht gelistet.
Das Paket trägt noch eine Alpha-Version: 0.0.1a8 erschien am 21. Oktober 2026 zusammen mit MarkItDown 0.1.9, nach einer ersten Alpha im März 2025.
MarkItDown MCP installieren
pip install markitdown-mcpLohnt sich MarkItDown MCP?
MarkItDown MCP ist der günstigste Weg, an Kontext wie an Geld, einen lokalen Agenten Office-Dateien und PDFs lesen zu lassen, und sein Sicherheitsmodell läuft darauf hinaus, allem auf dem Rechner zu vertrauen. Ein einziges Tool bedeutet fast keinen Kontext-Overhead, und derselbe Aufruf verarbeitet eine lokale Datei, eine URL oder eingebettete Daten.
Die Formatabdeckung ist breit: PDF, Word, PowerPoint, Excel, EPub, HTML, CSV, JSON und XML, Bilder über EXIF-Metadaten und OCR, Audio über Transkription, ZIP-Archive und YouTube-URLs. Das MCP-Paket pinnt markitdown[all], jeder optionale Konverter wird also installiert, ob du ihn brauchst oder nicht. Das steckt hinter einem offenen Issue zu gescheiterten Installationen auf Windows ARM64.
Der Sicherheitsabschnitt der README ist ungewöhnlich direkt. Es gibt keine Authentifizierung, der Server läuft mit den Rechten deines Nutzers, und convert_to_markdown kann jede Datei lesen, die dieser Nutzer lesen kann, und alles im Netzwerk abrufen. Stell das neben einen Agenten, der nicht vertrauenswürdige Dokumente liest, und eine per Prompt Injection eingeschleuste Anweisung, file:///home/you/.ssh/config umzuwandeln, ist ein plausibler Fehlerfall. Der Weg über Docker mit einem einzigen eingehängten Ordner ist die vernünftige Voreinstellung, wobei du das Image selbst baust: Ein offizielles Image wird nicht veröffentlicht.
Schlechter als die Konkurrenz ist alles nach der Umwandlung. Es gibt keine Suche, kein Chunking und keine Seitenauswahl, ein PDF mit 300 Seiten landet also an einem Stück im Kontext, und die Ausgabe zielt auf Textstruktur statt auf ein originalgetreues Layout. Nach 19 Monaten und acht Alphas trägt das Paket weiter die Version 0.0.1, und ein offenes Issue merkt an, dass die MCP-Galerie von VS Code noch 0.0.1a4 installiert.
Wo es sich lohnt
Finanzanalystin in einer Firma mit 30 Leuten, die Claude Desktop nutzt
Quartalsunterlagen aus Excel und PowerPoint zusammenfassen, ohne sie in eine Web-App hochzuladen
Das Docker-Image bauen, nur den Berichtsordner unter /workdir einhängen und Claude Desktop auf docker run richten. Die Umwandlung ist kostenlos und lokal; die Kosten sind Modell-Tokens, denn jede Arbeitsmappe kommt komplett an.
KI-Engineer, der auf dem Claude Agent SDK einen Agenten zur Dokumentaufnahme baut
Gemischte Kunden-Uploads vor dem Chunking in Markdown umwandeln
markitdown-mcp --http auf 127.0.0.1:3001 in einem Container betreiben und Uploads als data:-URIs übergeben, damit der Server nie Dateisystemzugriff braucht. Chunking und Seitenauswahl müssen in deinem eigenen Code stecken.
Security Engineer, der MCP-Server für Entwickler-Laptops freigibt
Entscheiden, ob MarkItDown installiert werden darf
Nur die Docker-Konfiguration mit einem eingehängten Verzeichnis und ohne Bindung außerhalb von localhost erlauben. Eine bloße pip-Installation läuft mit dem vollen Dateizugriff des Nutzers, ein Dokument mit eingeschleusten Anweisungen könnte den Agenten also Dateien außerhalb des Projekts lesen lassen.
Bevor du dich festlegst
- Einrichtung
- pip install markitdown-mcp (Python 3.10+) und markitdown-mcp für stdio ausführen oder markitdown-mcp --http --host 127.0.0.1 --port 3001 für Streamable HTTP und SSE. Für Claude Desktop das Image aus dem Dockerfile bauen und mit docker run starten. Bis zum ersten Aufruf vergehen Minuten.
- Integrationen
- Ein Tool, convert_to_markdown(uri), das URIs mit http:, https:, file: oder data: annimmt. Es schreibt nichts, kann aber alles lesen, was der Prozess erreicht; der MCP Inspector ist der dokumentierte Weg zur Fehlersuche.
- Daten und Datenschutz
- Läuft lokal ohne Konto, und nichts geht an Microsoft. Es gibt keine Authentifizierung, und im HTTP-Modus kann jeder lokale Prozess oder Nutzer es aufrufen. Abgerufene Seiten und Dokumente sind nicht vertrauenswürdiger Text im Kontext des Modells.
- Kosten im großen Maßstab
- Kostenlos unter MIT; die Rechnung sind Modell-Tokens. Weil das Tool keinen Parameter für Seiten oder Größe hat, kann ein einziges langes PDF in einem Aufruf einen großen Teil des Kontextfensters belegen.
- Grenzen
- Keine Seitenaufteilung, kein Chunking und keine Suche, und das Layout wird zu Textstruktur geglättet. Offene Issues melden gescheiterte Installationen auf Windows ARM64 wegen der Pflichtabhängigkeit markitdown[all] und dass die Galerie von VS Code die alte 0.0.1a4 installiert.
Was gut ist
- Ein Tool, also fast kein Kontext-Overhead
- Wandelt PDF, Office, EPub, HTML, Bilder, Audio und ZIP um
- Nimmt URIs mit file, http(s) und data an
- MIT-Lizenz; Dockerfile zur Isolierung
Was nicht
- Keine Authentifizierung; liest jede Datei, die der Nutzer lesen kann
- Ganze Dokumente landen im Kontext, ohne Seitenaufteilung
- Kein veröffentlichtes Docker-Image; du baust es selbst
- Weiterhin Alpha-Version 0.0.1a8
Am besten für
Entwickler, die einen Agenten PDFs und Office-Dokumente lokal lesen lassen wollen, ohne sie irgendwohin hochzuladen.
Alternativen zu MarkItDown MCP
MarkItDown MCP: häufige Fragen
- Lohnt sich MarkItDown MCP?
- Ein Dokumentkonverter mit einem einzigen Tool, der seinen Platz verdient, vorausgesetzt, er läuft in einem Container, der nur die Dateien sieht, die er sehen soll. Wir bewerten es mit 3.9 von 5.
- Was kostet MarkItDown MCP?
- Kostenlos und Open Source (MIT).
- Welche Nachteile hat MarkItDown MCP?
- Keine Authentifizierung; liest jede Datei, die der Nutzer lesen kann; Ganze Dokumente landen im Kontext, ohne Seitenaufteilung; Kein veröffentlichtes Docker-Image; du baust es selbst; Weiterhin Alpha-Version 0.0.1a8.
- Für wen eignet sich MarkItDown MCP?
- Entwickler, die einen Agenten PDFs und Office-Dokumente lokal lesen lassen wollen, ohne sie irgendwohin hochzuladen.
- Was kostet MarkItDown MCP für ein Team oder im Produktivbetrieb?
- Kostenlos unter MIT; die Rechnung sind Modell-Tokens. Weil das Tool keinen Parameter für Seiten oder Größe hat, kann ein einziges langes PDF in einem Aufruf einen großen Teil des Kontextfensters belegen.
- Ist MarkItDown MCP sicher für Firmendaten?
- Läuft lokal ohne Konto, und nichts geht an Microsoft. Es gibt keine Authentifizierung, und im HTTP-Modus kann jeder lokale Prozess oder Nutzer es aufrufen. Abgerufene Seiten und Dokumente sind nicht vertrauenswürdiger Text im Kontext des Modells.
- Was sind die besten Alternativen zu MarkItDown MCP?
- Die nächsten Alternativen, die wir getestet haben, sind Fetch (reference server), Filesystem (reference server) und Firecrawl MCP.
Antworten geprüft am 23. Okt. 2026.