Home
Login

Markdownify est un serveur de protocole de contexte de modèle (MCP) qui convertit divers types de fichiers et de contenu Web au format Markdown. Il offre une suite d'outils pour transformer des PDF, des images, des fichiers audio, des pages Web, etc., en texte Markdown facile à lire et à partager.

MITTypeScript 1.7kzcaceres Last Updated: 2025-05-19

Aperçu du Projet

Markdownify MCP Server est un serveur Model Context Protocol (MCP) développé par Zach Caceres (GitHub : zcaceres), conçu pour convertir divers types de fichiers et contenus web au format Markdown.

  • Utilisation principale : Fournir un service de conversion Markdown unifié pour les agents d'IA ou les outils de bureau.
  • Environnement pris en charge : Basé sur TypeScript + Node.js, fonctionnant avec des composants d'outils Python.

Fonctionnalités / Caractéristiques Principales

✅ Conversion de divers formats de fichiers en Markdown

Type Outils pris en charge
Documents Conversion PDF, DOCX, XLSX, PPTX en Markdown
Médias Images (avec métadonnées), Audio (avec transcription)
Contenu Web Pages web ordinaires, vidéos YouTube, résultats de recherche Bing

Liste complète des outils (indiquée dans le README) :

  • pdf-to-markdown
  • docx-to-markdown
  • xlsx-to-markdown
  • pptx-to-markdown
  • image-to-markdown
  • audio-to-markdown
  • webpage-to-markdown
  • youtube-to-markdown
  • bing-search-to-markdown
  • get-markdown-file : Permet de récupérer des fichiers .md ou .markdown existants

🔧 Configuration de l'environnement et utilisation

  1. Cloner le dépôt
  2. Installer les dépendances : pnpm install (et installera les dépendances uv/python)
  3. Compiler : pnpm run build
  4. Démarrer le serveur : pnpm start

Vous pouvez démarrer le mode TS watch avec pnpm run dev et modifier src/server.ts ou src/tools.ts pour personnaliser le comportement. Il peut également être intégré dans un client de bureau (comme Cursor), en déclarant ce service MCP dans la configuration JSON.

⚙️ Configuration Optionnelle

  • Prise en charge de la restriction du répertoire autorisé à lire les fichiers Markdown via la variable d'environnement MD_SHARE_DIR, améliorant ainsi le contrôle d'accès ([github.com][1]).

Résumé et Recommandations

  • Avantages

    • Prise en charge d'une grande variété de types de fichiers, fonctionnalités complètes
    • Intégration facile, peut être déployé de manière combinée
    • Communauté active, documentation détaillée, facile à prendre en main
  • Inconvénients / Points d'attention

    • Présente actuellement un risque de sécurité moyen, il est recommandé de l'utiliser uniquement dans un environnement isolé et sécurisé, ou d'attendre un correctif officiel.
    • La prise en charge de Windows doit encore être améliorée (l'auteur du projet espère que quelqu'un aidera à tester la PR Windows)
  • Cas d'utilisation

    • Lorsque les assistants IA ou les scripts d'automatisation nécessitent une entrée/sortie Markdown unifiée
    • Dans les scénarios de collecte de contenu, d'archivage de documents, d'organisation de documents de recherche, etc.
    • Projets Web ou de bureau qui souhaitent intégrer rapidement un service de conversion multi-format en Markdown