MCP.directory
Markdown Mindmap

Markdown Mindmap

yuchenssr

Converts Markdown text into interactive HTML mind maps for visual organization of structured content.

Transforms Markdown content into interactive HTML-based mind maps using markmap-cli, enabling visual organization of structured information and knowledge representation.

220306 views22Local (stdio)
productivity
GitHub

What it does

  • Convert Markdown to interactive HTML mind maps
  • Transform hierarchical text into visual diagrams
  • Generate browser-viewable mind map files
  • Process structured content with headings and lists

Best for

Content creators organizing notes and ideasStudents visualizing study materialsProject managers mapping out workflowsWriters structuring documents and outlines
Interactive HTML outputWorks with existing Markdown content

About Markdown Mindmap

Markdown Mindmap is a community-built MCP server published by yuchenssr that provides AI assistants with tools and capabilities via the Model Context Protocol. Transform your notes with Markdown Mindmap—convert Markdown into interactive mind maps for organized, visual knowledge r It is categorized under productivity. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.

How to install

You can install Markdown Mindmap in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

Markdown Mindmap is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

Tools (1)

convert_markdown_to_mindmap

Convert Markdown content to a mindmap mind map. Args: markdown_content: The Markdown content to convert Returns: Either the HTML content or the file path to the generated HTML, depending on the --return-type server argument

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/[email protected]"></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

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`: 
{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

or

recommended:

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

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;

return_html_content

html_preview

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 !

generate_file

file_to_open

using `python`:

Using a specific Python file in this repository:

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

or

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

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:

docker pull ychen94/mindmap-converter-mcp

Second, set the server:

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ 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.

Troubleshooting

File Not Found
If your mind map file isn't accessible:
1 Check that you've correctly mounted a volume to the Docker container
2 Ensure the path format is correct for your operating system
3 Make sure Docker has permission to access the directory

Docker Command Not Found
1 Verify Docker is installed and in your PATH
2 Try using the absolute path to Docker

Server Not Appearing in Claude
1 Restart Claude for Desktop after configuration changes
2 Check Claude logs for connection errors
3 Verify Docker is running

Advanced Usage
Using with Other MCP Clients
This server works with any MCP-compatible client, not just Claude for Desktop. The server implements the Model Context Protocol (MCP) version 1.0 specification.

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:

# 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:

markdown content

"

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

see the result

aiworkflow

mindmapinbrowser

and more

License

This project is licensed under the MIT License. For more details, please see the LICENSE file in [this project repository](https://github.com/YuChenS

README truncated. View full README on GitHub.

Alternatives

GitHub

GitHub

github
27.6k

Extend your developer tools with GitHub MCP Server for advanced automation, supporting GitHub Student and student packag

OfficialRemotePopular
4.5k232
Task Master

Task Master

eyaltoledano
25.8k

Boost productivity with Task Master: an AI-powered tool for project management and agile development workflows, integrat

CommunityPopular
4.9k114
Mastra Docs

Mastra Docs

mastra-ai
21.8k

Mastra Docs: AI assistants with direct access to Mastra.ai’s full knowledge base for faster, smarter support and insight

OfficialPopular
3872
Beads

Beads

steveyegge
18.6k

Beads — a drop-in memory upgrade for your coding agent that boosts context, speed, and reliability with zero friction.

OfficialPopular
8084

Related Skills

Browse all skills
pdf-to-markdown

Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.

582
literature-review

Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.). This skill should be used when conducting systematic literature reviews, meta-analyses, research synthesis, or comprehensive literature searches across biomedical, scientific, and technical domains. Creates professionally formatted markdown documents and PDFs with verified citations in multiple citation styles (APA, Nature, Vancouver, etc.).

377
slidev

Comprehensive guide for Slidev - a web-based presentation framework for developers. Covers Markdown syntax, layouts, components, animations, theming, and exporting. Use this skill when creating or working with developer presentations using Slidev.

264
markitdown

Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing. Use when converting documents to markdown, extracting text from PDFs/Office files, transcribing audio, performing OCR on images, extracting YouTube transcripts, or processing batches of files. Supports 20+ formats including DOCX, XLSX, PPTX, PDF, HTML, EPUB, CSV, JSON, images with OCR, and audio with transcription.

90
garmin-connect

Syncs daily health and fitness data from Garmin Connect into markdown files. Provides sleep, activity, heart rate, stress, body battery, HRV, SpO2, and weight data.

42
feishu-docs

飞书文档(Docx)API技能。用于创建、读取、更新和删除飞书文档。支持Markdown/HTML内容转换、文档权限管理。

31