Happy slice of mcp pizzaMCP.pizza

markmap-mcp-server

MCP.Pizza Chef: jinzcdev

Paste in an outline or point at a Markdown file on your computer, and you get a clickable mind map whose branches expand and collapse in your browser. Everything is generated locally, so no account or paid key is involved. Saving a map as a picture in PNG, JPG or SVG form also works, but only after you install one extra browser component. It can list the maps you have already made and clean out old ones.

Notes
Writing

Use This MCP server To

Turn a long meeting note into a clickable mind map Visualize a project plan as branches I can expand Save a mind map as a PNG for my slides Convert a Markdown file on my computer into a map Review a study outline as a picture instead of text Clean up old mind maps I no longer need

README

Markmap MCP Server

Sample Mindmap

NPM Version NPM Downloads GitHub License 中文文档 Stars

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 --offline inlines 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

  1. Node.js v20 or above
  2. 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.)

markmap-mcp-server FAQ

Which apps does this work in?
Any assistant that supports MCP, including Claude Desktop and Cursor. Setup is a short block pasted into that app's config file.
Is the project still maintained?
Yes. The repository had new commits within the past week, and the package is published on npm.
Do I need an account or a paid key?
No. Maps are built entirely on your own machine and nothing is sent to an outside service.
Can I use this to make a mind map picture for a slide deck?
Yes, in PNG, JPG or SVG. Picture export needs one extra install step (a bundled Chromium browser) that the plain interactive map does not.
How hard is setup?
Copy a small block into your assistant's config file. You also need Node.js version 20 or newer already installed.
Does it change my original notes?
No. It only reads the Markdown you paste or point it at, and writes new map files into a folder you choose.