Markmap MCP Server MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Herramienta única de Markdown a mapa mental: coloca Markdown y obtén un árbol renderizado
Salida interactiva: hacer zoom, desplazarse, expandir/contraer nodos
Exportar a PNG/JPG/SVG desde la página renderizada
Apertura automática en el navegador predeterminado (opcional)
MARKMAP_DIR env var para controlar dónde aterrizan las salidas

Demo en vivo

Cómo se ve en la práctica

markmap-mcp-server.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/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"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Markmap MCP Server

Convierta las notas de la reunión en un mapa mental para compartirlas rápidamente

👤 PM y líderes de equipo que ejecutan sincronizaciones con muchas notas ⏱ ~10 min beginner

Cuándo usarlo: Después de una reunión, cuando una lista plana oculta la forma de la discusión.

Requisitos previos

Nodo 18+ — instalación nvm 18

Flujo

Que la agente redacte Markdown

Resuma la reunión de planificación de hoy como un esquema de Markdown anidado con temas de nivel superior.✓ Copiado

→ El esquema tiene de 3 a 5 temas principales, subpuntos anidados
Prestar

Ejecute Markdown-to-mindmap en ese esquema, ábralo en el navegador.✓ Copiado

→ Se abre un mapa mental interactivo; los nodos colapsan/expanden
Exportar

Exporte el mapa a SVG y suelte el archivo en el documento del equipo.✓ Copiado

→ SVG guardado en MARKMAP_DIR

Resultado: Un mapa mental compartible que codifica la forma de la reunión, no solo sus palabras.

Errores comunes

El contorno es demasiado superficial: todo se convierte en un nodo de nivel superior — Forzar el anidamiento: pregunte por temas → subpuntos → hechos de apoyo

Combinar con: filesystem

Construya un mapa de estudio a partir de un capítulo de un libro de texto.

👤 Estudiantes y aprendices permanentes ⏱ ~20 min beginner

Cuándo usarlo: Ha leído un capítulo y desea una imagen visual única que pueda revisar antes de un examen.

Flujo

resumir el capitulo

Resuma el capítulo 4 del <libro> como un esquema jerárquico de Markdown.✓ Copiado

→ Borrar árbol de temas
Renderizar y exportar

Produzca un mapa mental y guárdelo como PNG en ~/study/.✓ Copiado

→ Archivo PNG listo para revisión

Resultado: Una ayuda de estudio visual que tarda unos segundos en escanearse.

Combinar con: paper-fetch-skill

Redacte un mapa de arquitectura informal antes de escribir un diagrama completo

👤 Ingenieros dibujando antes de comprometerse con draw.io/figma ⏱ ~15 min intermediate

Cuándo usarlo: Quiere un diagrama de "pista de conversación" de 2 minutos, no un documento de arquitectura pulido.

Flujo

Listar servicios en Markdown

Resuma los servicios en este repositorio como un árbol de Markdown anidado agrupado por dominio.✓ Copiado

→ El esquema agrupado refleja la estructura del código base
Prestar

Conviértelo en un mapa mental y exporta SVG.✓ Copiado

→ SVG que puedes colocar en el documento de diseño.

Resultado: Un diagrama de seguimiento de conversaciones en minutos; actualice a un diagrama de arquitectura real más adelante solo si es necesario.

Errores comunes

Tratándolo como el artefacto final — Úselo como herramienta de pensamiento; reemplazar con un diagrama formal antes de publicar

Combinar con: mermaid-skill

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

markmap-mcp-server + filesystem

Leer un documento extenso, resumirlo en un esquema de Markdown y representarlo como un mapa mental

Lea ./notes/long-doc.md, produzca un esquema anidado y luego preséntelo como un mapa mental.✓ Copiado

markmap-mcp-server + mermaid-skill

Elija el objeto visual adecuado: sirena para flujos, mapa de marcas para jerarquías

Decide si se trata de un flujo (sirena) o una jerarquía (mapa de marcas) y renderiza en consecuencia.✓ Copiado

markmap-mcp-server + paper-fetch-skill

Obtener el resumen/secciones de un artículo, mapear la estructura del argumento

Busque el artículo, extraiga los títulos de las secciones y los puntos clave, presente el argumento como un mapa mental.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
markdown-to-mindmap	markdown: str, open?: bool	Convierta un esquema de Markdown anidado en un mapa mental interactivo	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno: se representa localmente
Tokens por llamada: Pequeña: tamaño de contorno
Monetario: Gratis
Consejo: Mantenga los contornos en ~100 nodos para facilitar la lectura; Los mapas más grandes tardan en desplazarse/exportarse.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales: renderizado sin conexión

Salida de datos: Sin salida de red. Fuentes y JS incluidos localmente.

Si configura MARKMAP_DIR dentro de un repositorio de git, los archivos HTML/PNG generados pueden terminar comprometidos; agregue el directorio de salida a .gitignore.

Resolución de problemas

Errores comunes y soluciones

La navegador no se abrió

Establezca open=false y abra manualmente la ruta HTML devuelta; confirme que un navegador predeterminado esté registrado.

Verificar: open $(returned_path) on macOS

El PNG exportado está en blanco

Espere un segundo hasta que el mapa se procese por completo antes de exportarlo. Aumente el retraso en la configuración o ejecute la exportación dos veces.

Verificar: Open the HTML in a browser and check it renders before export

Permiso denegado para escribir en MARKMAP_DIR

Apunte MARKMAP_DIR a una ruta de escritura en su directorio de inicio.

Verificar: touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

Alternativas

Markmap MCP Server vs otros

Alternativa	Cuándo usarla	Contrapartida
mermaid-skill	Sus datos son un flujo o secuencia, no una jerarquía	Paradigma de diagrama diferente
excalidraw-skill	Quieres imágenes incompletas dibujadas a mano	Sin diseño automático; posicionamiento manual
antv-chart	Necesitas gráficos estadísticos, no mapas mentales	Clase de salida diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills