Mindmap MCP Server

Mindmap MCP Server is an MCP server that converts hierarchical Markdown content into interactive visual mindmaps using the markmap-cli library. It connects LLM applications, such as Claude Desktop, directly to visualization tools that transform structured text into dynamic HTML diagrams. Knowledge workers, developers, researchers, and project planners use this server to inspect complex ideas visually without manually assembling flowchart nodes. The server enables users to output mindmaps either as raw HTML markup suitable for display inside client UI artifacts or as standalone HTML files saved to a local folder to conserve tokens and facilitate browser viewing. The resulting diagrams support hierarchical heading navigation, links, code formatting, and mathematical equations. It can be installed locally via Python or uvx, or run in an isolated environment using Docker.

Category: Design, Media & Creative

Tags: diagrams, markdown, mindmap, visualization

Visit Mindmap MCP Server

How to install and configure Mindmap MCP Server

1. Ensure Node.js is installed on your machine if running via Python or uvx. 2. In your client configuration file (such as claude_desktop_config.json), add the server entry under mcpServers using uvx: json { "mcpServers": { "mindmap": { "command": "uvx", "args": ["mindmap-mcp-server", "--return-type", "filePath"] } } } 3. Alternatively, install via pip using pip install mindmap-mcp-server or deploy using the Docker image ychen94/mindmap-converter-mcp:latest with a mounted volume. 4. Restart your MCP client to load the tools.

What you can do with Mindmap MCP Server

• Converting project planning outlines into interactive visual mindmaps to track frontend, backend, and testing stages. - Saving generated mindmaps directly to disk to conserve client context tokens during long conversations. - Rendering mathematical formulas and code blocks inside expandable tree diagrams for technical documentation review. - Visualizing complex research notes or market competitor analyses generated during brainstorming sessions. - Previewing structured Markdown hierarchies immediately inside client artifacts using direct HTML string returns.

Key facts

• https://github.com/YuChenSSR/mindmap-mcp-server
• Design, Media & Creative, Files, Documents & PDFs, Notes & Knowledge Management
• diagrams, markdown, mindmap, visualization

Part of MCP Servers

What is Mindmap MCP Server?

Mindmap MCP Server is a Model Context Protocol tool that translates structured Markdown text into interactive HTML mindmaps using Markmap. It allows AI clients to render visual hierarchies directly in chat artifacts or save them locally as HTML files.

How do I install Mindmap MCP Server?

You can install it using pip with pip install mindmap-mcp-server, launch it using uvx mindmap-mcp-server, or deploy it via Docker using the ychen94/mindmap-converter-mcp image. A Node.js environment is required when running via Python or uvx.

What is the difference between html and filePath return types?

The html return type sends raw HTML strings directly into your chat client for inline artifact previewing. The filePath return type writes the HTML mindmap to a local file and outputs its path, which reduces context token consumption and lets you open the diagram in any web browser.

Which MCP clients work with Mindmap MCP Server?

The server supports Claude Desktop as well as any other client implementing the Model Context Protocol 1.0 specification.

Is Mindmap MCP Server open source?

Yes, Mindmap MCP Server is an open source project distributed under the MIT License on GitHub.