Log inSubmit server
Markmap MCP Server logo

Markmap MCP Server

by jinzcdev

Converts structured Markdown into interactive HTML mind maps and optional PNG, JPG, or SVG files locally.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Markmap MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "jinzcdev-markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 4 tools correctly (1mo ago).

Overview

The jinzcdev/markmap-mcp-server MCP server converts structured Markdown headings and nested lists into interactive mind maps. It writes HTML to a configured local directory and can export PNG, JPG, or SVG files through Playwright and Chromium. Use it for architecture outlines, plans, notes, and other hierarchical content; restructure flat text before conversion. It also provides tools to list, retrieve, and clean up generated markmap files.

Use cases

  • Convert architecture notes into an interactive mind map
  • Export a project outline as PNG or SVG
  • Preview generated HTML mind maps in a browser
  • List and retrieve previously generated mind map files
  • Clean up old markmap outputs

Key features

  • Markdown headings and nested lists to interactive HTML mind maps
  • PNG, JPG, and SVG export through Playwright
  • Local output directory with configurable return modes
  • Generated-file listing, retrieval, and cleanup tools
  • Optional offline HTML asset bundling
  • Browser preview and in-page export controls

Tools4

What Markmap MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 76d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @jinzcdev/markmap-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars289Stargazers on the source repository.
npm downloads479Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed4Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Markmap MCP Server works

What jinzcdev/markmap-mcp-server MCP server does

The jinzcdev/markmap-mcp-server MCP server turns Markdown structure into visual mind maps using markmap. Headings and nested list items become the hierarchy in an interactive HTML document. The generated viewer includes zoom and collapse behavior, a browser export toolbar, and a Markdown copy action.

The main generation tool accepts Markdown directly or an absolute path to a local .md file. It can produce HTML by default, or create PNG, JPG, or SVG output in addition to the HTML source. Generated files are written beneath the configured output directory. If a filename is reused, the existing generated file is overwritten.

The server also supports a local file workflow. list_mindmaps finds recent files whose names begin with markmap, get_mindmap retrieves a generated file, and cleanup_mindmaps removes generated files according to age or an all-files option.

How it works

The jinzcdev/markmap-mcp-server MCP server runs locally over MCP and does not call external APIs or require third-party service credentials. HTML generation is normally quick. Image export starts a headless Chromium process through Playwright and requires both the Playwright package and its Chromium browser installation.

Generation always creates an HTML source file. For an image request, the image becomes the primary artifact while the HTML path remains available in the response. Return behavior is controlled at startup: path returns file paths, content returns inline HTML or an MCP image block where supported, and both returns paths plus inline content. Large HTML output can fall back to paths.

Browser opening is also a startup preference. The server can always open a browser, never open one, or expose an agent-controlled option. The default is never. Offline mode can inline page assets so generated HTML does not depend on CDN access.

Setup and configuration

Node.js 20 or newer is required. The package can be run directly with npx:

Terminal
npx -y @jinzcdev/markmap-mcp-server

Set the output location with --output or MARKMAP_DIR; the default is ~/.markmap-mcp. MARKMAP_OPEN or --open controls browser behavior, and MARKMAP_RETURN_MODE or --return-mode controls response content. Use --offline or MARKMAP_OFFLINE=true to enable self-contained HTML. Command-line flags take precedence over environment variables.

For PNG, JPG, or SVG export, install Playwright and Chromium separately:

Terminal
npm install playwright
npx playwright install chromium

A Docker workflow is also documented, using /data/markmap as the container output location through MARKMAP_DIR.

Tools and capabilities

  • markdown_to_mindmap accepts Markdown or a local Markdown path and supports html, png, jpg, and svg formats.
  • list_mindmaps lists matching generated files newest first and has a configurable limit.
  • get_mindmap reads a file only when its absolute path remains inside the configured output directory. Small HTML and SVG files can include text content; PNG and JPG results provide metadata only.
  • cleanup_mindmaps deletes files older than a selected number of days or all matching files. Use dryRun=true first to preview deletion because the default is destructive.
  • The mindmap_from_content prompt helps structure notes as Markdown before calling the generation tool.

Limitations and notes

The input should already express a hierarchy through headings or nested lists. Flat, unstructured text is not the intended input. The server writes local files and does not provide cloud storage or external mind-map APIs.

Image export is slower than HTML and depends on a working Playwright Chromium installation. get_mindmap rejects paths outside the configured output directory. PNG and JPG retrieval returns metadata rather than image content, so regenerate with an image format when the agent needs pixels. Cleanup is irreversible when dryRun is false, so preview targets before committing deletion.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Markmap MCP Server

Run `npx -y @jinzcdev/markmap-mcp-server` with Node.js 20 or newer.

Yes. The README provides a stdio MCP configuration example for Claude Desktop, and also mentions Cursor.

Call `markdown_to_mindmap` with `format` set to `png`. Server-side image export additionally requires the Playwright package and Chromium to be installed.

No. Conversion runs locally and does not require external APIs or third-party keys.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMarkmap MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/jinzcdev-markmap-mcp-server?style=directory)](https://allmcps.com/mcp/jinzcdev-markmap-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/jinzcdev-markmap-mcp-server"><img src="https://allmcps.com/api/badge/jinzcdev-markmap-mcp-server?style=directory" alt="Markmap MCP Server on AllMCPs" /></a>