mindmap-mcp-server

MCP.Pizza Chef: YuChenSSR

Hand over an outline and back comes an interactive mind map, either as a page you can preview inside the chat or as a file saved for your browser. That single conversion is all it does: no editing, no picture export. Nothing has changed in the project since May 2025, and its own notes suggest falling back to a plain writing prompt, or the Markmap editor extension, when it misbehaves. Node.js must be installed even if you set it up through Python.

Unmaintained · no changes since May 2025
Notes
Writing

Use This MCP server To

Turn my rough outline into a mind map Preview a mind map right inside the chat Save a mind map as a file I can open later See the shape of a long document at a glance Sketch a plan visually before writing it up

README

Mindmap MCP Server

mindmap_mcp

A Model Context Protocol (MCP) server for converting Markdown content to interactive mindmaps.

Installation

pip install mindmap-mcp-server

Or using uvx:

uvx mindmap-mcp-server

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
You are a specialized assistant that generates HTML code for interactive markdown-based mind maps (markmaps). When a user sends you content, respond with a complete HTML document that displays their content as a markmap visualization.
If artifact tool is turned on, you can use the artifact.

Follow these requirements:
1. Use the markmap-autoloader library (version 0.18 or latest stable version)
2. Format the HTML exactly according to the template below
3. Replace the demo content in the template with the user's content, preserving their hierarchical structure
4. Maintain the markmap configuration options (maxWidth: 300, colorFreezeLevel: 2)
5. If the user doesn't provide markdown formatting (# for headings), format their content appropriately with main topics using # and subtopics using ##

Template to follow:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/markmap-autoloader@0.18"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

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): system_prompt_artifact

  2. Render the HTML file as a mindmap: system_prompt_render


mindmap-mcp-server FAQ

Is this still maintained?
No. The last change was May 2025, over a year ago. It still runs, but nothing has been fixed since, and the author offers a plain writing prompt as a fallback.
Do I need a key or an account?
No. The conversion happens on your own computer and nothing is sent away.
How hard is setup?
Developer level. Node.js has to be present even if you install the server through Python tools, and Windows users are steered towards the Docker version.
Can I use this to visualize a long document?
Yes, provided the document is in Markdown or you paste the outline in. It builds one interactive map from that text.
Can it export a PNG or a PDF of the map?
No. You get an interactive page or a saved file, and turning that into a picture is left to you in the browser.
Which apps does it work in?
Claude Desktop and VS Code are documented. In Claude Desktop the map can be previewed directly if you choose the page option.
Is there an alternative if it will not run?
The author points Windows users to the Markmap editor extension for VS Code and includes a writing prompt that produces the same kind of map with nothing installed.