Markmap Visualization

v0.1.1โ€ขDeveloper Toolsโ€ขstable

๐Ÿ“‡ ๐Ÿ  - An MCP server built on [markmap](https://github.com/markmap/markmap) that converts **Markdown** to interactive **mind maps**. Supports multi-format exports (PNG/JPG/SVG), live browser preview, one-click Markdown copy, and dynamic visualization

aillmmarkmapmcpmcp-server
Share:
202
Stars
0
Downloads
0
Weekly
0/5

What is Markmap Visualization?

Markmap Visualization is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“‡ ๐Ÿ  - an mcp server built on [markmap](https://github.com/markmap/markmap) that converts **markdown** to interactive **mind maps**. supports multi-format exports (png/jpg/svg), live browser preview,...

๐Ÿ“‡ ๐Ÿ  - An MCP server built on [markmap](https://github.com/markmap/markmap) that converts **Markdown** to interactive **mind maps**. Supports multi-format exports (PNG/JPG/SVG), live browser preview, one-click Markdown copy, and dynamic visualization

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Convert Markdown to interactive mind maps
Export diagrams as PNG, JPG, SVG
Dynamic knowledge visualization
jinzcdev

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.1.1
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @jinzcdev/markmap-mcp-server

Manual Installation

npx -y @jinzcdev/markmap-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Markmap Visualization

Markmap MCP Server converts Markdown text into interactive, zoomable mind maps that can be exported as PNG, JPG, or SVG files and previewed live in a browser. Built on the markmap library, it exposes a single focused tool โ€” markdown-to-mindmap โ€” that AI assistants can call to instantly visualize outlines, research notes, brainstorms, or documentation hierarchies. Writers, developers, and educators use it to turn structured text generated by AI into shareable visual diagrams without leaving their chat interface.

Prerequisites

  • Node.js 18 or higher
  • npx available (bundled with npm)
  • An MCP-compatible client such as Claude Desktop or Claude Code CLI
  • A web browser for the optional live preview feature
1

Install via Smithery (easiest)

The fastest way to install is through the Smithery CLI, which handles Claude Desktop registration automatically.

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude
2

Or run directly with npx

Alternatively, run the server on demand via npx without installing globally. You can specify a custom output directory with the --output flag.

# Default (outputs to system temp directory):
npx -y @jinzcdev/markmap-mcp-server

# With custom output directory:
npx -y @jinzcdev/markmap-mcp-server --output /Users/you/mindmaps
3

Optional: set output directory via environment variable

Set the MARKMAP_DIR environment variable to control where exported mind map files are saved. Command-line --output takes precedence when both are specified.

export MARKMAP_DIR="/Users/you/mindmaps"
4

Add to Claude Desktop config

Add the server configuration to claude_desktop_config.json to make it available in Claude Desktop.

5

Generate your first mind map

Ask Claude to convert any Markdown outline into a mind map. The markdown-to-mindmap tool accepts a markdown string and an optional 'open' flag to launch the browser preview.

Markmap Visualization Examples

Client configuration

Claude Desktop configuration for the Markmap MCP server with a custom output directory.

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/Users/you/mindmaps"
      }
    }
  }
}

Prompts to try

Example prompts that demonstrate mind map generation and export.

- "Create a mind map of the main topics in this article and open it in my browser"
- "Turn this project outline into a Markmap mind map and save it as an SVG"
- "Generate a mind map showing the key concepts of machine learning: supervised, unsupervised, and reinforcement learning"
- "Take my meeting notes and visualize them as an interactive mind map"
- "Create a mind map of REST API design principles and export it as a PNG"

Troubleshooting Markmap Visualization

Mind map files are not saved or cannot be found

Check the value of MARKMAP_DIR or the --output argument. If neither is set, files go to the OS temp directory (e.g., /tmp on macOS/Linux). Set MARKMAP_DIR to a permanent directory you control.

Browser preview does not open automatically

The 'open' parameter must be set to true when calling the markdown-to-mindmap tool. Ask Claude to 'open the mind map in my browser' to trigger the preview. Ensure a default browser is configured on your system.

npx fails with permission or cache errors

Clear the npx cache with 'npm cache clean --force' and retry. On macOS, if you see EACCES errors, ensure your npm global directory is writable or use a Node version manager like nvm.

Frequently Asked Questions about Markmap Visualization

What is Markmap Visualization?

Markmap Visualization is a Model Context Protocol (MCP) server that ๐Ÿ“‡ ๐Ÿ  - an mcp server built on [markmap](https://github.com/markmap/markmap) that converts **markdown** to interactive **mind maps**. supports multi-format exports (png/jpg/svg), live browser preview, one-click markdown copy, and dynamic visualization It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Markmap Visualization?

Install via npm with the command: npx -y @jinzcdev/markmap-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Markmap Visualization?

Markmap Visualization works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Markmap Visualization free to use?

Yes, Markmap Visualization is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use Markmap Visualization?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides