MCP

MarkItDown MCP : d'abord convertir une page https publique en Markdown

Pour qui veut transformer une page ou un fichier en Markdown sur cette machine ; sans authentification, tout fichier lisible par l'utilisateur l'est aussi — la première fois, seulement une URI https publique et STDIO.

Official source · microsoft/markitdown-mcp

Install

pip install markitdown-mcp

À qui ça s'adresse

Pour convertir sur cette machine un document ou une page web en Markdown et le donner à un agent de confiance. Les preuves indiquent : markitdown-mcp fournit des serveurs légers STDIO, Streamable HTTP et SSE, et n'expose qu'un outil, convert_to_markdown(uri) ; l'uri peut être http:, https:, file: ou data:.

Il est conçu pour des agents locaux de confiance. Pas d'authentification ; les droits du processus égalent l'utilisateur qui l'a lancé. convert_to_markdown peut lire tout fichier que cet utilisateur peut lire, et récupérer des données réseau. Ne l'ouvre pas à des clients non fiables sur une machine partagée.

Les preuves ne listent pas les clients. Ne lie pas HTTP/SSE ailleurs qu'à localhost, sauf si tu connais le risque.

Premier essai en 3 minutes

Prends le chemin principal pip ; ne fais pas de Docker l'installation principale :

pip install markitdown-mcp
markitdown-mcp

STDIO est le défaut. Pour HTTP/SSE, les preuves donnent :

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

La première fois, utilise STDIO et garde la liaison sur cette machine.

Prérequis : Python/pip locaux fonctionnent ; la première conversion est une page https: à laquelle tu as un accès public — ne fournis pas d'abord un fichier de clés ni un file: interne. Cela lira l'URI indiquée et pourra sortir sur le réseau.

Emplacement : dans le MCP client, mets command à markitdown-mcp (stdio). N'ouvre HTTP qu'après avoir compris que tout processus de cette machine peut y accéder.

Premier appel à faible risque : convert_to_markdown(uri) avec une uri https: publique. N'utilise pas file: vers le répertoire personnel ou des secrets, et ne change pas --host.

Signal de succès : l'outil renvoie le Markdown converti de cette URI. Si le processus ne démarre pas, vérifie d'abord le nom de paquet pip ; ne passe pas à Docker.

Cas d'usage

Cas 1 : convertir une page publique en Markdown. Appelle convert_to_markdown avec une uri https:. Les preuves garantissent seulement l'acceptation de ce type d'URI ; pas de style de sortie, de plafond de taille ni de traitement des murs de connexion. Tu confirmes : tu vois le texte converti.

Cas 2 : convertir un fichier local en Markdown. uri file:. Cela lit le disque avec les droits de l'utilisateur serveur ; en mode HTTP/SSE, d'autres processus de cette machine peuvent déclencher la même lecture. Vérifie d'abord que le chemin n'a pas de secrets. Une URI data: entre aussi en conversion ; les preuves ne documentent pas de limite de longueur. Le build Docker est docker build -t markitdown-mcp:latest . puis docker run -it --rm markitdown-mcp:latest, ce n'est pas le même chemin principal que pip.

Limites d'usage

Pas d'authentification ; les droits égalent l'utilisateur lanceur. HTTP/SSE se lie par défaut à localhost et reste joignable par d'autres processus ou utilisateurs de cette machine. Ne le lie pas à une autre NIC. Le seul outil est convert_to_markdown. Il lit fichiers et données réseau lisibles par l'utilisateur — pas un risque zéro, ni une écriture annulable : les preuves n'ont pas d'undo. Ne mets pas Docker et pip en installations principales parallèles.