Serveur MCP Markmap
Convertit des plans Markdown en cartes mentales interactives au format HTML, PNG, JPG ou SVG que les clients IA peuvent enregistrer et prévisualiser.
Aussi connu sous jinzcdev/markmap-mcp-server
- Étoiles
- 289
- Outils
- 7
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 4 août 2026
- Licence
- MIT
Qu'est-ce que Markmap MCP ?
Convertit des plans Markdown en cartes mentales interactives au format HTML, PNG, JPG ou SVG que les clients IA peuvent enregistrer et prévisualiser. Il expose 7 outils, comme markdown, format, filename.
Résumé généré à partir du README du projet
À propos du MCP server Markmap
Ce serveur permet aux développeurs utilisant des clients IA comme Claude Desktop ou Cursor de transformer des plans Markdown en diagrammes visuels. En convertissant les titres et les listes imbriquées en cartes mentales interactives, il aide les utilisateurs à visualiser des structures complexes via les formats HTML, PNG, JPG ou SVG. L'ensemble du processus s'exécute localement sur votre machine, garantissant la confidentialité sans nécessiter de clés API tierces.
Les utilisateurs peuvent interagir avec le serveur en utilisant des outils tels que markdown_to_mindmap pour générer des fichiers ou list_mindmaps pour consulter les derniers résultats. Si vous avez besoin d'exports d'images comme le PNG ou le SVG, le serveur utilise Playwright et Chromium pour effectuer la conversion côté serveur. Vous pouvez configurer la manière dont le serveur renvoie les données, en choisissant entre des chemins de fichiers, du HTML inline ou du contenu d'image en base64, et même le configurer pour un fonctionnement hors ligne en intégrant les ressources pour éviter les dépendances aux CDN.
Ce que vous pouvez faire avec
- 1Visualiser la documentation de conceptionConvertissez un document de conception complexe en une carte mentale structurée pour une compréhension facilitée.
- 2Générer des images prêtes pour le chatCréez une version PNG d'un plan afin que l'IA puisse fournir un aperçu d'image direct dans la discussion.
- 3Convertir des fichiers markdown existantsTransformez un fichier markdown local en une carte mentale HTML interactive en utilisant son chemin de fichier.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP Markmap 7
Détectés depuis le READMEmarkdownformatfilenameopenlimitalltopic
| markdown | — | |
| format | — | |
| filename | — | |
| open | — | |
| limit | — | |
| all | — | |
| topic | — |
Configuration
MARKMAP_DIRMARKMAP_OPENMARKMAP_RETURN_MODE
| Nom | Description | Type |
|---|---|---|
| MARKMAP_DIR | — | |
| MARKMAP_OPEN | — | |
| MARKMAP_RETURN_MODE | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblejinzcdev/markmap-mcp-server is public and reachablegithub.com/jinzcdev/markmap-mcp-server ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-08-04github.com/jinzcdev/markmap-mcp-server ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubMarkmap MCP Server
Markmap MCP Server is based on the Model Context Protocol (MCP). It converts Markdown into interactive mind maps using markmap, and can optionally export PNG / JPG / SVG on the server for Agent-friendly delivery. Generation runs locally — no third-party API keys required.
Features
- Markdown → Mind Map: Convert Markdown (headings + nested lists) to interactive HTML mind maps
- Agent-friendly returns: Return a file path, inline HTML, and/or image content (configured at startup)
- Server-side export: Export PNG / JPG / SVG via Playwright for chat/inline preview
- Browser preview: Configurable open behavior — always, never, or agent-decided (startup setting)
- Browser export toolbar: When viewing HTML, also export PNG/JPG/SVG or copy Markdown in the page UI
- Offline HTML: Startup
--offlineinlines assets so the page works without CDN access - File workflows: Read from
inputPath, list recent outputs, clean up old files - Privacy-first: Fully local conversion; no cloud mind-map API
Prerequisites
- Node.js v20 or above
- For server-side image export (
format: png|jpg|svg): install Playwright and Chromium
npm install playwright
npx playwright install chromium
(playwright is an optional dependency of this package.)
Installation
# Install from npm
npm install @jinzcdev/markmap-mcp-server -g
# Basic run
npx -y @jinzcdev/markmap-mcp-server
# Specify output directory and auto-open in browser
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory --open always
Docker
docker build -t markmap-mcp-server .
docker run --rm -i \
-v /path/to/output:/data/markmap \
-e MARKMAP_DIR=/data/markmap \
markmap-mcp-server
Or clone and run locally:
git clone https://github.com/jinzcdev/markmap-mcp-server.git
cd markmap-mcp-server
npm install && npm run build
# Optional: enable server-side image export
npx playwright install chromium
node build/index.js
Usage
Add the following configuration to your MCP client (Cursor / Claude Desktop / etc.):
{
"mcpServers": {
"markmap": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@jinzcdev/markmap-mcp-server"],
"env": {
"MARKMAP_DIR": "/path/to/output/directory",
"MARKMAP_OPEN": "never",
"MARKMAP_RETURN_MODE": "path"
}
}
}
}
Server preferences (CLI / env)
These are decided when the server starts — not tool arguments:
| Preference | CLI | Env | Values | Default |
|---|---|---|---|---|
| Output directory | --output / -o |
MARKMAP_DIR |
any directory path | ~/.markmap-mcp |
| Open in browser | --open [mode] |
MARKMAP_OPEN |
always | never | agent (bare --open = always) |
never |
| Return mode | --return-mode |
MARKMAP_RETURN_MODE |
path | content | both |
path |
| Offline HTML | --offline |
MARKMAP_OFFLINE |
true | false (CLI: pass --offline to enable) |
false |
CLI flags override environment variables. --output overrides MARKMAP_DIR.
--open: bare --open means always. You may also pass --open always|never|agent. An invalid value exits with an error. Without the flag, MARKMAP_OPEN is used (default never).
Return mode:
| Mode | Meaning |
|---|---|
path |
Paths JSON only (htmlFilePath + filePath) |
content |
Inline content only (raw HTML text, or a base64 image block) — no paths |
both |
Paths JSON plus inline content |
Generated HTML always includes the markmap toolbar, English export labels, and fully expanded nodes.
Example prompts
- “Summarize this design doc as a mind map.”
- “Convert
./notes/architecture.mdto a mind map.” - “Generate a PNG mind map of this outline for the chat.”
Available Tools
markdown_to_mindmap
Convert Markdown into an interactive mind map (and optionally an image).
| Parameter | Type | Default | Description |
|---|---|---|---|
markdown |
string | — | Markdown content (required unless inputPath is set). Wins when both are provided. |
inputPath |
string | — | Absolute path to a local .md file |
format |
html | png | svg | jpg |
html |
Output format. Image formats need Playwright |
filename |
string | auto | Output base name (sanitized; prefixed with markmap- if needed; reusing overwrites) |
open |
boolean | false |
Whether to open the result in browser. Only exposed when server open mode is agent (--open agent / MARKMAP_OPEN=agent). |
Return (returnMode=path):
{
"htmlFilePath": "/path/to/markmap-….html",
"filePath": "/path/to/markmap-….html"
}
For image formats, filePath is the image path and htmlFilePath is still the HTML source.
Return (returnMode=content): Raw HTML text block, or an MCP image content block (base64) for png/jpg/svg — no paths JSON. Oversized HTML (≥200KB) falls back to paths JSON.
Return (returnMode=both): Paths JSON plus the inline content above.
Note: Interactive zoom/collapse and the in-page “Export PNG/JPG/SVG” buttons are part of the HTML viewer. Server-side
format: png|jpg|svgis what Agents can consume directly without a manual browser click.
list_mindmaps
List recent generated files in the output directory (newest first). Only files whose names start with markmap are included.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit |
number | 20 |
Max files to return (1–200) |
Returns {outputDir, files: [{name, filePath, size, mtimeMs, mtime}]}.
get_mindmap
Retrieve a generated mind map file by its absolute path. Path must stay inside the configured output directory (path traversal denied).
| Parameter | Type | Default | Description |
|---|---|---|---|
filePath |
string | — | Absolute path to the mind map file (HTML or image) |
Returns JSON {filePath, mimeType, size}. For HTML/SVG under 200KB, also appends a text content block. PNG/JPG return metadata only (no image block) — re-export via markdown_to_mindmap with format=png\|jpg if pixels are needed.
cleanup_mindmaps
Delete old (or all) generated mind map files.
| Parameter | Type | Default | Description |
|---|---|---|---|
maxAgeDays |
number | 7 |
Delete files older than this many days |
all |
boolean | false |
If true, delete all markmap files |
dryRun |
boolean | false |
If true, preview without deleting |
Prompt: mindmap_from_content
Helper prompt that asks the model to structure notes as Markdown, then call markdown_to_mindmap.
| Parameter | Type | Default | Description |
|---|---|---|---|
topic |
string | — | Topic or raw notes to organize as a map |
Related Projects
| Project | Description |
|---|---|
| MarkXMind Online | Create XMind mind maps with Markdown online. Try it → |
| Obsidian MarkXMind Plugin | Render XMindMark syntax as XMind mind maps inside Obsidian. |
License
This project is licensed under the MIT License.
Questions sur Markmap MCP
Quels outils Markmap MCP fournit-il ?
Il expose 7 outils, dont markdown, format, filename, open, limit.
Le MCP server Markmap nécessite-t-il une clé API ?
Non. La conversion s'effectue entièrement en local, aucune clé API tierce n'est donc requise.
Quels formats d'image peut-il exporter ?
Il exporte du PNG, du JPG ou du SVG via le serveur en utilisant Playwright, et le visualiseur HTML propose également des boutons d'exportation.
Quelles sont les prérequis Node.js pour ce MCP server ?
Vous avez besoin de Node.js v20 ou supérieur, ainsi que de Playwright avec Chromium pour l'exportation d'images côté serveur.
Où sont sauvegardés les fichiers de cartes mentales générés ?
Ils sont envoyés dans le répertoire de sortie, par défaut ~/.markmap-mcp, et ce répertoire est configurable via --output ou MARKMAP_DIR.