YuChenSSR/mindmap-mcp-server

A Model Context Protocol (MCP) server for converting Markdown content to interactive mindmaps.
Installation
Or using uvx:
Or using docker safer and easier.
Attention
Three installation methods have been successfully tested on macOS and Linux.
For Windows users experiencing issues with npx for this MCP, consider using the Docker method. Alternatively, if you use Visual Studio Code, the "Markmap" extension offers a potentially simpler solution than navigating command-line tools.
---
If you're experiencing unresolved issues, you can use my recent system prompt as a Mindmap Assistant instead of using this MCP server.
Using my system prompt instead of using this MCP server
*Visualization options:* (If formulas or symbols don’t display correctly, download the HTML file and open it in a browser.)
1. View the mindmap in artifacts (if available):
2. Render the HTML file as a mindmap:
---
Prerequisites
This package requires Node.js to be installed when using command python or uvx to run the server.
Usage
With Claude Desktop or other MCP clients
Add this server to your claude_desktop_config.json:
using uvx:
or
recommended:
we use --return-type to specify the return type of the mindmap content, you can choose html or filePath according to your needs.
html will return the entire HTML content of the mindmap, which you can preview in your AI client's artifact;
filePath will save the mindmap to a file and return the file path,which you can open in your browser. It can **save your tokens** !
using python:
Using a specific Python file in this repository:
or
we use --return-type to specify the return type of the mindmap content, you can choose html or filePath according to your needs. see using \uvx\ for more details.
using docker:
First, you pull the image:
Second, set the server:
⚠️ Replace /path/to/output/folder with an actual path on your system where you want to save mind maps, such as /Users/username/Downloads on macOS or C:\\Users\\username\\Downloads on Windows.
**Tools Provided in the docker container**
The server provides the following MCP tools:
1. **markdown-to-mindmap-content**
Converts Markdown to an HTML mind map and returns the entire HTML content.
You don't use the args: -v and /path/to/output/folder:/output in the command docker.
**Parameters**:
• markdown (string, required): The Markdown content to convert
• toolbar (boolean, optional): Whether to show the toolbar (default: true)
**Best for**: Simple mind maps where the HTML content size isn't a concern. And you can use **artifact** in your AI client to preview the mindmap.
2. **markdown-to-mindmap-file**
Converts Markdown to an HTML mind map and saves it to a file in the mounted directory.
**Parameters**:
• markdown (string, required): The Markdown content to convert
• filename (string, optional): Custom filename (default: auto-generated timestamp name)
• toolbar (boolean, optional): Whether to show the toolbar (default: true)
**Best for**: Complex mind maps or when you want to **save the tokens** for later use.
you can open the html file in your browser to view the mindmap. Also you can use the iterm-mcp-server or other terminals' mcp servers to open the file in your browser without interrupting your workflow.