Markmap MCP Server MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Outil de démarque unique vers carte mentale : déposez Markdown et obtenez un arbre rendu
Sortie interactive : zoom, panoramique, développement/réduction des nœuds
Exporter vers PNG / JPG / SVG à partir de la page rendue
Ouverture automatique dans le navigateur par défaut (facultatif)
MARKMAP_DIR env var pour contrôler où les sorties atterrissent

Démo en direct

Aperçu en pratique

markmap-mcp-server.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "markmap-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "markmap-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jinzcdev/markmap-mcp-server"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Markmap MCP Server

Transformez les notes de réunion en carte mentale pour un partage rapide

👤 PM et chefs d'équipe exécutant des synchronisations contenant beaucoup de notes ⏱ ~10 min beginner

Quand l'utiliser : Après une réunion, lorsqu'une liste à puces plate cache la forme de la discussion.

Prérequis

Nœud 18+ — nvm installer 18

Déroulement

Demandez à l'agent de rédiger une version Markdown

Résumez la réunion de planification d'aujourd'hui sous la forme d'un plan Markdown imbriqué avec des thèmes de niveau supérieur.✓ Copié

→ Le plan comporte 3 à 5 thèmes principaux, des sous-points imbriqués
Rendre

Exécutez markdown-to-mindmap sur ce plan, ouvrez-le dans le navigateur.✓ Copié

→ La carte mentale interactive s'ouvre ; les nœuds s'effondrent/s'agrandissent
Exporter

Exportez la carte au format SVG et déposez le fichier dans le document de l'équipe.✓ Copié

→ SVG enregistré sous MARKMAP_DIR

Résultat : Une carte mentale partageable qui code la forme de la réunion, pas seulement ses mots.

Pièges

Contour trop superficiel : tout devient un nœud de niveau supérieur — Forcer l'imbrication : demander des thèmes → sous-points → faits à l'appui

Combiner avec : filesystem

Construire une carte d'étude à partir d'un chapitre de manuel

👤 Étudiants et apprenants tout au long de la vie ⏱ ~20 min beginner

Quand l'utiliser : Vous avez lu un chapitre et souhaitez un visuel à image unique que vous pouvez consulter avant un examen.

Déroulement

Résumer le chapitre

Résumez le chapitre 4 de <book> sous la forme d'un aperçu hiérarchique du Markdown.✓ Copié

→ Effacer l'arborescence des sujets
Rendu et exportation

Créez une carte mentale et enregistrez-la au format PNG dans ~/study/.✓ Copié

→ Fichier PNG prêt à être examiné

Résultat : Une aide à l'étude visuelle qui prend quelques secondes à numériser.

Combiner avec : paper-fetch-skill

Rédigez une carte d'architecture informelle avant d'écrire un diagramme complet

👤 Les ingénieurs dessinent avant de s'engager sur draw.io/figma ⏱ ~15 min intermediate

Quand l'utiliser : Vous voulez un diagramme « talk-track » de 2 minutes, pas un document d'architecture soigné.

Déroulement

Répertorier les services dans Markdown

Décrivez les services de ce référentiel sous la forme d'une arborescence Markdown imbriquée regroupée par domaine.✓ Copié

→ Le plan groupé reflète la structure de la base de code
Rendre

Transformez-le en carte mentale et exportez SVG.✓ Copié

→ SVG que vous pouvez déposer dans le document de conception

Résultat : Un diagramme de conversation en quelques minutes ; passez à un véritable diagramme d'architecture plus tard, uniquement si nécessaire.

Pièges

Le traiter comme l'artefact final — Utilisez-le comme outil de réflexion ; remplacer par un diagramme formel avant de publier

Combiner avec : mermaid-skill

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

markmap-mcp-server + filesystem

Lire un long document, résumer dans un plan Markdown, afficher sous forme de carte mentale

Lisez ./notes/long-doc.md, produisez un plan imbriqué, puis affichez-le sous forme de carte mentale.✓ Copié

markmap-mcp-server + mermaid-skill

Choisissez le bon visuel : sirène pour les flux, markmap pour les hiérarchies

Décidez s'il s'agit d'un flux (sirène) ou d'une hiérarchie (markmap) et effectuez le rendu en conséquence.✓ Copié

markmap-mcp-server + paper-fetch-skill

Récupérer le résumé/les sections d'un article, cartographier la structure des arguments

Récupérez le document, extrayez les titres de section et les points clés, présentez l'argument sous forme de carte mentale.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
markdown-to-mindmap	markdown: str, open?: bool	Convertissez un plan Markdown imbriqué en une carte mentale interactive	0

Coût et limites

Coût d'exécution

Quota d'API: Aucun — rendu localement
Tokens par appel: Petit : taille du contour
Monétaire: Gratuite
Astuce: Gardez les contours à environ 100 nœuds pour plus de lisibilité ; les cartes plus grandes sont lentes à effectuer un panoramique/exportation.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucune information d'identification - rendu hors ligne

Sortie de données : Aucune sortie réseau. Polices et JS regroupés localement.

Si vous définissez MARKMAP_DIR dans un dépôt git, les fichiers HTML/PNG générés peuvent finir par être validés ; ajoutez le répertoire de sortie à .gitignore.

Dépannage

Erreurs courantes et correctifs

Le navigateur ne s'est pas ouvert

Définissez open=false et ouvrez manuellement le chemin HTML renvoyé ; confirmez qu'un navigateur par défaut est enregistré.

Vérifier : open $(returned_path) on macOS

Le PNG exporté est vide

Attendez une seconde que la carte soit entièrement rendue avant de l'exporter. Augmentez le délai de configuration ou exécutez l'exportation deux fois.

Vérifier : Open the HTML in a browser and check it renders before export

Autorisation refusée pour écrire dans MARKMAP_DIR

Pointez MARKMAP_DIR sur un chemin accessible en écriture dans votre répertoire personnel.

Vérifier : touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

Alternatives

Markmap MCP Server vs autres

Alternative	Quand l'utiliser	Compromis
mermaid-skill	Vos données sont un flux ou une séquence, pas une hiérarchie	Paradigme de diagramme différent
excalidraw-skill	Vous voulez des visuels sommaires dessinés à la main	Pas de mise en page automatique ; positionnement manuel
antv-chart	Vous avez besoin de graphiques statistiques, pas de cartes mentales	Classe de sortie différente

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills