Labsco
YuChenSSR logo

Mindmap MCP Server

β˜… 235

from YuChenSSR

Convert Markdown content into interactive mindmaps.

πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeQuick setup

Mindmap MCP Server

<p align="center"> <img src="https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-21/JMi7Mn89Hw5ikd9z.jpeg" alt="mindmap_mcp" width="50%"> </p>

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

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.

<details> <summary>Using my system prompt instead of using this MCP server</summary>
Copy & paste β€” that's it
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

</details>

Features

This server provides a tool for converting Markdown content to mindmaps using the markmap-cli library:

  • Convert Markdown to interactive mindmap HTML
  • Option to create offline-capable mindmaps
  • Option to hide the toolbar
  • Return either HTML content or file path

Example

In Claude, you can ask:

"give a mindmap for the following markdown code, using a mindmap tool:

Copy & paste β€” that's it
# Project Planning

## Research

### Market Analysis
### Competitor Review

## Design

### Wireframes
### Mockups

## Development

### Frontend
### Backend

## Testing

### Unit Tests
### User Testing

"

if you want to save the mindmap to a file, and then open it in your browser using the iTerm MCP server:

"give a mindmap for the following markdown input_code using a mindmap tool, after that,use iterm to open the generated html file. input_code:

Copy & paste β€” that's it
markdown content

"

"Think about the process of putting an elephant into a refrigerator, and provide a mind map. Open it with a terminal."

<details> <summary>see the result</summary>

aiworkflow

mindmapinbrowser

</details>

and more

License

This project is licensed under the MIT License. For more details, please see the LICENSE file in this project repository


If this project is helpful to you, please consider giving it a Star ⭐️

The advancement of technology ought to benefit all individuals rather than exploit the general populace.