Mindmap
A Model Context Protocol server that converts Markdown content into interactive mindmaps, allowing AI assistants to visualize hierarchical information through either HTML content or saved files.
What is Mindmap?
Mindmap is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that converts markdown content into interactive mindmaps, allowing ai assistants to visualize hierarchical information through either html content or saved files.
A Model Context Protocol server that converts Markdown content into interactive mindmaps, allowing AI assistants to visualize hierarchical information through either HTML content or saved files.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that converts Markdown conte
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mindmap-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mindmap
The Mindmap MCP Server converts Markdown-structured content into interactive, browser-renderable mindmaps powered by the markmap library, letting AI assistants visualize hierarchical information without any manual diagramming. It accepts Markdown headings and bullet lists as input and returns either a complete HTML artifact for immediate preview or saves the mindmap to a file path — useful for conserving tokens in long sessions. Writers, educators, and developers use it to transform outlines, meeting notes, documentation structures, or brainstorming sessions into visual mindmaps in a single prompt.
Prerequisites
- Node.js installed (required even when using the Python or uvx methods, as markmap uses it internally)
- Python 3.10+ and the uv tool, OR Docker for the containerized approach
- An MCP-compatible AI client such as Claude Desktop or Cursor
- Optional: a mounted output directory if using Docker or the filePath return type
Choose your installation method
The easiest approach is uvx, which requires no prior installation. Alternatively, install via pip or use Docker for isolated environments.
# Via uvx (recommended, no install needed):
uvx mindmap-mcp-server
# Via pip:
pip install mindmap-mcp-server
# Via Docker:
docker pull ychen94/mindmap-converter-mcpDecide on a return type
The server supports two output modes controlled by the --return-type argument: 'html' returns the full HTML content inline (good for Claude artifacts), and 'filePath' saves to disk and returns the path (saves tokens).
Configure the server in your MCP client
Add mindmap-mcp-server to your MCP client configuration. Use the --return-type argument to select your preferred output mode.
For Docker users: mount an output directory
When using the Docker image, mount a local directory to /output so generated mindmap files are accessible on your host.
docker run --rm -i -v /path/to/output:/output ychen94/mindmap-converter-mcpRestart your MCP client and test
Restart your MCP client to load the new server, then send a mindmap request with Markdown content to confirm it works.
Mindmap Examples
Client configuration (uvx, html return type)
Add the mindmap server to Claude Desktop using uvx. The html return type lets Claude render the mindmap as an artifact in the conversation.
{
"mcpServers": {
"mindmap": {
"command": "uvx",
"args": ["mindmap-mcp-server", "--return-type", "html"]
}
}
}Client configuration (filePath return type)
Use the filePath return type to save mindmaps to disk and avoid returning large HTML blobs in the conversation.
{
"mcpServers": {
"mindmap": {
"command": "uvx",
"args": ["mindmap-mcp-server", "--return-type", "filePath"]
}
}
}Prompts to try
Use these prompts to generate mindmaps from your content.
- "Create a mindmap for this Markdown outline: # Project Plan\n## Phase 1\n- Research\n- Design\n## Phase 2\n- Development\n- Testing"
- "Turn my meeting notes into a mindmap. Notes: [paste your notes here]"
- "Generate a mindmap of the main concepts in machine learning: supervised, unsupervised, and reinforcement learning."
- "Create a mindmap for planning a product launch and save it as a file."
- "Visualize the folder structure of my project as a mindmap."Troubleshooting Mindmap
Server fails to start with a Node.js not found error
The mindmap-mcp-server requires Node.js even when installed via pip or uvx. Install Node.js from nodejs.org and ensure the 'node' binary is in your PATH before restarting the MCP client.
Mindmap HTML is returned but Claude does not render it visually
Claude Desktop renders HTML artifacts automatically. Make sure you are using a version of Claude Desktop that supports artifact rendering. Alternatively, save the returned HTML to a .html file and open it in a browser.
Docker version: mindmap files are not found after generation
Ensure your -v mount points to a directory that exists on your host and that the container has write permission. The container saves files to /output, so mount a local path there: -v /home/user/mindmaps:/output.
Frequently Asked Questions about Mindmap
What is Mindmap?
Mindmap is a Model Context Protocol (MCP) server that model context protocol server that converts markdown content into interactive mindmaps, allowing ai assistants to visualize hierarchical information through either html content or saved files. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mindmap?
Follow the installation instructions on the Mindmap GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mindmap?
Mindmap works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mindmap free to use?
Yes, Mindmap is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Mindmap Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Mindmap? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mindmap in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mindmap?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.