MCP server de Markmap
Convierte esquemas de Markdown en mapas mentales interactivos en formatos HTML, PNG, JPG o SVG que los clientes de IA pueden guardar y previsualizar.
También conocido como jinzcdev/markmap-mcp-server
- Stars
- 289
- Herramientas
- 7
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 4 ago 2026
- Licencia
- MIT
¿Qué es Markmap MCP?
Convierte esquemas de Markdown en mapas mentales interactivos en formatos HTML, PNG, JPG o SVG que los clientes de IA pueden guardar y previsualizar. Expone 7 herramientas, como markdown, format, filename.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Markmap
Transformar esquemas de Markdown en diagramas visuales es lo que este servidor permite a los desarrolladores que utilizan clientes de IA como Claude Desktop o Cursor. Al convertir encabezados y listas anidadas en mapas mentales interactivos, ayuda a los usuarios a visualizar estructuras complejas mediante formatos HTML, PNG, JPG o SVG. Todo el proceso se ejecuta localmente en tu máquina, garantizando la privacidad sin necesidad de API keys de terceros.
Los usuarios pueden interactuar con el servidor utilizando herramientas como markdown_to_mindmap para generar archivos o list_mindmaps para ver los resultados recientes. Si necesitas exportaciones de imagen como PNG o SVG, el servidor utiliza Playwright y Chromium para realizar la conversión en el lado del servidor. Puedes configurar cómo el servidor devuelve los datos, eligiendo entre rutas de archivos, HTML en línea o contenido de imagen en base64, e incluso configurarlo para que funcione sin conexión integrando los assets para evitar dependencias de CDN.
Qué puedes hacer con él
- 1Visualizar documentación de diseñoConvierte un documento de diseño complejo en un mapa mental estructurado para facilitar su comprensión.
- 2Generar imágenes listas para el chatCrea una versión PNG de un esquema para que la IA pueda proporcionar una vista previa de imagen directa en el chat.
- 3Convertir archivos markdown existentesTransforma un archivo markdown local en un mapa mental HTML interactivo utilizando su ruta de archivo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de Markmap MCP 7
Detectado desde el READMEmarkdownformatfilenameopenlimitalltopic
| markdown | — | |
| format | — | |
| filename | — | |
| open | — | |
| limit | — | |
| all | — | |
| topic | — |
Configuración
MARKMAP_DIRMARKMAP_OPENMARKMAP_RETURN_MODE
| Nombre | Descripción | Tipo |
|---|---|---|
| MARKMAP_DIR | — | |
| MARKMAP_OPEN | — | |
| MARKMAP_RETURN_MODE | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblejinzcdev/markmap-mcp-server is public and reachablegithub.com/jinzcdev/markmap-mcp-server ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-08-04github.com/jinzcdev/markmap-mcp-server ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre Markmap MCP
¿Qué herramientas proporciona Markmap MCP?
Expone 7 herramientas, incluidas markdown, format, filename, open, limit.
¿El Markmap MCP server necesita una API key?
No. La conversión se realiza de forma totalmente local, por lo que no se requieren API keys de terceros.
¿Qué formatos de imagen puede exportar?
Exporta PNG, JPG o SVG en el servidor usando Playwright, y el visor HTML también ofrece botones de exportación.
¿Cuáles son los requisitos de Node.js para este MCP server?
Necesitas Node.js v20 o superior, y Playwright con Chromium para la exportación de imágenes en el servidor.
¿Dónde se guardan los archivos de mapas mentales generados?
Se guardan en el directorio de salida, que por defecto es ~/.markmap-mcp y es configurable mediante --output o MARKMAP_DIR.