Qu’est-ce que MarkItDown MCP ?
MarkItDown est l'outil Python de Microsoft pour convertir des fichiers et documents bureautiques en Markdown ; le dépôt principal a environ 191 700 étoiles GitHub. Le paquet markitdown-mcp l'habille comme serveur MCP, construit par l'équipe AutoGen.
Il expose exactement un outil, convert_to_markdown(uri), qui accepte les URI http:, https:, file: ou data:. Il tourne sur stdio par défaut, ou sur Streamable HTTP et SSE avec le flag --http, en se liant à localhost. Installez-le avec pip install markitdown-mcp ; pour Claude Desktop, le README recommande de construire l'image Docker depuis le Dockerfile du dépôt et de monter un dossier pour les fichiers locaux. Il n'est pas listé dans le registre MCP officiel.
Le paquet est encore en version alpha : 0.0.1a8 est sortie le 21 octobre 2026 aux côtés de MarkItDown 0.1.9, après une première alpha en mars 2025.
Installer MarkItDown MCP
pip install markitdown-mcpMarkItDown MCP vaut-il le coup ?
MarkItDown MCP est la façon la moins chère, en contexte et en argent, de laisser un agent local lire des fichiers Office et des PDF, et son modèle de sécurité revient à faire confiance à tout sur la machine. Un seul outil signifie presque aucun surcoût de contexte, et le même appel gère un fichier local, une URL ou des données inline.
La couverture de formats est large : PDF, Word, PowerPoint, Excel, EPub, HTML, CSV, JSON et XML, les images via les métadonnées EXIF et l'OCR, l'audio via la transcription, les archives ZIP et les URL YouTube. Le paquet MCP épingle markitdown[all], si bien que chaque convertisseur optionnel est installé que vous en ayez besoin ou non, ce qui est derrière une issue ouverte rapportant des installations ratées sur Windows ARM64.
La section de sécurité du README est exceptionnellement franche. Il n'y a pas d'authentification, le serveur tourne avec les privilèges de votre utilisateur, et convert_to_markdown peut lire tout fichier que cet utilisateur peut lire ou récupérer n'importe quoi sur le réseau. Mettez cela à côté d'un agent qui lit des documents non fiables et une instruction victime d'injection de prompt de convertir file:///home/you/.ssh/config est un échec plausible. La route Docker avec un seul dossier monté est le défaut sensé, bien que vous construisiez l'image vous-même : aucune image officielle n'est publiée.
Ce qu'il fait moins bien que les rivaux, c'est tout ce qui vient après la conversion. Il n'y a pas de recherche, de découpage ou de sélection de pages, si bien qu'un PDF de 300 pages atterrit dans le contexte en un bloc, et la sortie vise la structure du texte plutôt qu'une mise en page fidèle. Après 19 mois et huit alphas, le paquet porte encore une version 0.0.1, et une issue ouverte note que la galerie MCP de VS Code installe encore 0.0.1a4.
Là où il fait la différence
Un analyste financier dans une entreprise de 30 personnes qui utilise Claude Desktop
Résumer les dossiers trimestriels Excel et PowerPoint sans les téléverser vers une appli web
Construisez l'image Docker, montez seulement le dossier des rapports à /workdir et pointez Claude Desktop vers docker run. La conversion est gratuite et locale ; le coût est les tokens de modèle, puisque chaque classeur arrive entier.
Un ingénieur IA qui construit un agent d'ingestion de documents sur le Claude Agent SDK
Transformer des téléversements clients mixtes en Markdown avant le découpage
Faites tourner markitdown-mcp --http sur 127.0.0.1:3001 dans un conteneur et passez les téléversements comme URI data:, pour que le serveur n'ait jamais besoin d'accès au système de fichiers. Le découpage et la sélection de pages doivent vivre dans votre propre code.
Un ingénieur sécurité qui approuve les serveurs MCP pour les portables des développeurs
Décider si MarkItDown peut être installé
N'autorisez que la configuration Docker avec un répertoire monté et aucune liaison hors localhost. Un simple pip install tourne avec le plein accès aux fichiers de l'utilisateur, si bien qu'un document portant des instructions injectées pourrait faire lire à l'agent des fichiers hors du projet.
Avant de vous engager
- Mise en route
- pip install markitdown-mcp (Python 3.10+) et lancez markitdown-mcp pour stdio, ou markitdown-mcp --http --host 127.0.0.1 --port 3001 pour Streamable HTTP et SSE. Pour Claude Desktop, construisez l'image depuis le Dockerfile et lancez-la avec docker run. Quelques minutes jusqu'au premier appel.
- Intégrations
- Un outil, convert_to_markdown(uri), prenant les URI http:, https:, file: ou data:. Il n'écrit rien, mais il peut lire tout ce que le processus peut atteindre ; le MCP Inspector est la route de débogage documentée.
- Données et confidentialité
- Tourne localement sans compte et rien envoyé à Microsoft. Il n'y a pas d'authentification, et en mode HTTP n'importe quel processus ou utilisateur local peut l'appeler. Les pages et documents récupérés sont du texte non fiable dans le contexte du modèle.
- Coût à grande échelle
- Gratuit sous MIT ; la facture est les tokens de modèle. Parce que l'outil n'a pas de paramètre de page ou de taille, un long PDF peut prendre une grande part de la fenêtre de contexte en un seul appel.
- Limites
- Pas de pagination, de découpage ni de recherche, et la mise en page est aplatie en structure de texte. Les issues ouvertes rapportent des échecs d'installation sur Windows ARM64 à cause de la dépendance obligatoire markitdown[all] et la galerie de VS Code installant l'ancien 0.0.1a4.
Les points forts
- Un seul outil, donc presque aucun surcoût de contexte
- Convertit PDF, Office, EPub, HTML, images, audio et ZIP
- Accepte les URI file, http(s) et data
- Licence MIT ; Dockerfile pour l'isolation
Les points faibles
- Pas d'authentification ; lit tout fichier que l'utilisateur peut
- Les documents entiers atterrissent dans le contexte, sans pagination
- Pas d'image Docker publiée ; vous la construisez
- Encore en version alpha à 0.0.1a8
Idéal pour
Les développeurs qui veulent qu'un agent lise des PDF et documents Office localement sans les téléverser nulle part.
Alternatives à MarkItDown MCP
MarkItDown MCP : questions fréquentes
- MarkItDown MCP vaut-il le coup ?
- Un convertisseur de documents à un seul outil qui gagne sa place, pourvu qu'il tourne dans un conteneur qui ne peut voir que les fichiers que vous voulez. Nous lui donnons 3.9 sur 5.
- Combien coûte MarkItDown MCP ?
- Gratuit et open source (MIT).
- Quels sont les inconvénients de MarkItDown MCP ?
- Pas d'authentification ; lit tout fichier que l'utilisateur peut; les documents entiers atterrissent dans le contexte, sans pagination; pas d'image Docker publiée ; vous la construisez; encore en version alpha à 0.0.1a8.
- À qui s’adresse MarkItDown MCP ?
- Les développeurs qui veulent qu'un agent lise des PDF et documents Office localement sans les téléverser nulle part.
- Combien coûte MarkItDown MCP pour une équipe ou en production ?
- Gratuit sous MIT ; la facture est les tokens de modèle. Parce que l'outil n'a pas de paramètre de page ou de taille, un long PDF peut prendre une grande part de la fenêtre de contexte en un seul appel.
- MarkItDown MCP est-il sûr pour les données de l’entreprise ?
- Tourne localement sans compte et rien envoyé à Microsoft. Il n'y a pas d'authentification, et en mode HTTP n'importe quel processus ou utilisateur local peut l'appeler. Les pages et documents récupérés sont du texte non fiable dans le contexte du modèle.
- Quelles sont les meilleures alternatives à MarkItDown MCP ?
- Les alternatives les plus proches que nous avons testées sont Fetch (reference server), Filesystem (reference server) et Firecrawl MCP.
Réponses vérifiées le 23 oct. 2026.