markmap

Markmap MCP Server converts Markdown into interactive mind maps using the MCP framework. Built on top of the markmap project, it exposes a toolchain that allows you to submit Markdown content and receive an interactive mind map that can be explored, zoomed, and exported to image formats. The server can be run via npx for quick use or installed locally for ongoing development. You can expose a streamable HTTP endpoint to integrate with MCP clients, and you can inspect available tools using the inspector utility. The core tool exposed by this server is markdown-to-mindmap, which takes Markdown text and returns an HTML representation of the mind map along with metadata about success and content length. You can also copy the original Markdown content and view automatic browser previews depending on how you configure the client.

Prerequisites:

• Node.js (recommended v25 as noted by the project)

Installation options:

1. Global install and run via npx (quick start):

# Install from npm and run using npx
# Basic run
npm install @isdmx/markmap-mcp-server -g
npx -y @isdmx/markmap-mcp-server

# Specify output directory (optional)
npx -y @isdmx/markmap-mcp-server --output /path/to/output/directory

# Or simply
markmap-mcp-server

2. Clone the repository and run locally:

# Clone the repository
git clone https://github.com/isdmx/markmap-mcp-server.git

# Navigate to the project directory
cd markmap-mcp-server

# Build and run
npm install && npm run build

# Run the server
node build/index.js

Prerequisites and notes:

• Ensure Node.js is installed (and compatible with the server requirements).
• If building from source, you’ll need npm and a working network connection to fetch dependencies.
• The server can be run directly via npx for quick usage or via a local build for development workflows.

Tips and common scenarios:

• The MCP client configuration typically points to a streamable HTTP endpoint provided by the server. Example configuration can be found in the README, showing how to add a default-server with type streamable-http and a local URL like http://localhost:3000/mcp.
• To list or invoke Tools via inspector, install the inspector globally and use mcp-inspector with the appropriate server URL and tool name (e.g., markdown_to_mindmap).
• The available tool is markdown-to-mindmap, which accepts a single markdown string and returns an HTML mind map along with metadata (html, contentLength, success, and potentially error).
• If you run into port or URL issues, ensure the MCP endpoint (e.g., /mcp) is accessible from the client and that any firewall rules allow HTTP traffic.
• You can export the generated mind map to image formats or integrate the server into automation pipelines via the MCP protocol.