MarkItDown MCP: Zuerst eine öffentliche https-Seite nach Markdown wandeln

Für wen

Für alle, die auf diesem Rechner ein Dokument oder eine Webseite nach Markdown wandeln und einem vertrauenswürdigen Agenten übergeben wollen. Die Evidenz sagt: markitdown-mcp stellt leichte STDIO-, Streamable HTTP- und SSE-Server bereit und legt nur ein Tool frei, convert_to_markdown(uri); die uri kann http:, https:, file: oder data: sein.

Es ist für lokale, vertrauenswürdige Agenten gedacht. Es gibt keine Authentifizierung; Prozessrechte entsprechen dem startenden Nutzer. convert_to_markdown kann jede Datei lesen, die dieser Nutzer lesen kann, und Netzdaten holen. Auf einer geteilten Maschine nicht für untrusted Clients öffnen.

Die Evidenz listet keine Clients. HTTP/SSE nicht an etwas anderes als localhost binden, sofern du das Risiko nicht kennst.

Erster Versuch in 3 Minuten

Nimm den pip-Hauptpfad; Docker ist nicht die Hauptinstallation:

pip install markitdown-mcp
markitdown-mcp

STDIO ist der Default. Für HTTP/SSE gibt die Evidenz:

markitdown-mcp --http --host 127.0.0.1 --port 3001

Beim ersten Mal STDIO nutzen und die Bindung auf diesem Rechner lassen.

Voraussetzungen: Lokales Python/pip funktioniert; die erste Wandlung ist eine https:-Seite, auf die du öffentlich zugreifen darfst — zuerst keine Schlüsseldatei und kein internes file:. Die angegebene URI wird gelesen, Netzverkehr ist möglich.

Konfiguration: Im Client-MCP command auf markitdown-mcp (stdio) setzen. HTTP erst öffnen, wenn klar ist, dass jeder Prozess auf diesem Rechner zugreifen kann.

Risikoarmer erster Aufruf: convert_to_markdown(uri) mit einer öffentlichen https:-uri. Kein file: auf Home oder Schlüssel, --host nicht ändern.

Erfolgssignal: Das Tool liefert aus dieser URI gewandeltes Markdown. Startet der Prozess nicht, zuerst den pip-Paketnamen prüfen; nicht auf Docker wechseln.

Anwendungsfälle

Fall 1: Eine öffentliche Webseite nach Markdown. convert_to_markdown mit uri https:. Die Evidenz garantiert nur die Annahme solcher URIs; Stil, Größenlimit und Login-Walls fehlen. Bestätigt ist: du siehst den gewandelten Text.

Fall 2: Eine lokale Datei nach Markdown. uri file:. Das liest die Platte als Server-Nutzer; im HTTP/SSE-Modus können andere Prozesse auf diesem Rechner denselben Read auslösen. Zuerst prüfen, dass der Pfad keine Schlüssel enthält. Eine data:-URI geht ebenfalls in die Wandlung; die Evidenz nennt kein Längenlimit. Docker-Build ist docker build -t markitdown-mcp:latest . danach docker run -it --rm markitdown-mcp:latest — nicht derselbe Hauptpfad wie pip.

Grenzen

Keine Authentifizierung; Rechte gleich dem startenden Nutzer. HTTP/SSE bindet standardmäßig an localhost und ist trotzdem für andere Prozesse oder Nutzer auf diesem Rechner erreichbar. Nicht an eine andere NIC binden. Einziges Tool: convert_to_markdown. Es liest Dateien und Netzdaten, die der Nutzer lesen kann — kein Nullrisiko und kein rückgängig machbares Schreiben: die Evidenz hat kein undo. Docker und pip nicht als parallele Hauptinstallationen führen.