Log inSubmit server
Mindmap MCP Server logo

Mindmap MCP Server

by YuChenSSR

Converts Markdown into interactive Markmap HTML, returned directly or saved as a browser-openable file.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mindmap MCP Server

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yuchenssr-mindmap-mcp-server": {
      "command": "uvx",
      "args": [
        "mindmap-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

uvx mindmap-mcp-server

Downloading pydantic-core (2.0MiB) Downloading cryptography (4.5MiB) Downloaded pydantic-core Downloaded cryptography Installed 29 packages in 13ms Traceback (most recent call last): File "/home/user/.cache/uv/archive-v0/jSzQcQrhTx40gQcQ/bin/mindmap-mcp-server", line 6, in <module> from mindmap_mcp_server.server import main File "/home/user/.cache/uv/archive-v0/jSzQcQrhTx40gQcQ/lib/python3.11/site-packages/mindmap_mcp_server/server.py", line 12, in <module> from mcp.server.fastmcp

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

YuChenSSR/mindmap-mcp-server MCP server converts Markdown content into interactive mindmap HTML using markmap-cli. It can return the complete HTML document or save the result to a file and return its path. The server exposes separate tools for content and file output, with an optional toolbar setting. Reach for it when an MCP-compatible client needs to turn structured Markdown into a visual hierarchy.

Use cases

  • Convert project notes into an interactive mindmap
  • Preview Markdown hierarchies as HTML in an MCP client
  • Save large mindmaps as browser-openable files
  • Hide the visualization toolbar in generated maps

Key features

  • Convert Markdown to interactive mindmap HTML
  • Return HTML content or a file path
  • Save generated maps to files
  • Show or hide the toolbar
  • Support uvx, pip, Python, and Docker launch methods

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/21 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mindmap-mcp-server (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars240Stargazers on the source repository.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Mindmap MCP Server works

What YuChenSSR/mindmap-mcp-server MCP server does

YuChenSSR/mindmap-mcp-server MCP server turns Markdown into interactive mindmaps rendered as HTML. Markdown headings and list structure provide the hierarchy used by the visualization. The generated result can be previewed as HTML in a client artifact or opened in a browser when saved to disk.

The project uses the markmap-cli library and supports two output styles:

  • Return the full HTML content to the MCP client.
  • Write the HTML to a file and return its path.

The file-oriented option is useful for larger maps because the client does not need to receive the entire HTML document in its response. Generated mindmaps can also be configured to show or hide the toolbar, and the project lists an option for creating offline-capable mindmaps.

How it works

An MCP client sends Markdown text to one of the server's conversion tools. For content output, the server creates an interactive HTML mindmap and returns that document. For file output, it writes the generated HTML to a destination and reports the resulting path. The file tool accepts an optional filename; without one, the server generates a timestamp-based name.

The Docker image exposes the same two tool patterns. markdown-to-mindmap-content accepts required Markdown and an optional toolbar boolean, which defaults to true. markdown-to-mindmap-file accepts required Markdown, an optional filename, and the same toolbar setting. Docker users must mount a host directory at /output when they want files written outside the container.

Setup and configuration

YuChenSSR/mindmap-mcp-server MCP server can be installed from PyPI with pip install mindmap-mcp-server, or launched with uvx mindmap-mcp-server. A client configuration can add uvx as the command and pass mindmap-mcp-server plus --return-type html or --return-type filePath. The latter is the documented choice when the client should receive a path instead of the full HTML.

When launched with Python or uvx, Node.js is also required. A Python configuration can point directly to the repository's mindmap_mcp_server/server.py, but the example path must be replaced with a real local path. Docker users can pull ychen94/mindmap-converter-mcp and run it with an input-enabled container plus an /output volume mount.

The server implements MCP version 1.0 and is documented for Claude Desktop and other MCP-compatible clients. After changing a Claude Desktop configuration, restart the application and check its logs if the server does not appear.

Tools and capabilities

The documented capabilities are:

  • Convert Markdown into interactive mindmap HTML.
  • Return HTML directly for artifact preview.
  • Save HTML to a file for browser viewing.
  • Choose whether the visualization toolbar is displayed.
  • Select HTML or file-path output through --return-type.

Limitations and notes

The README reports successful testing of the three installation approaches on macOS and Linux. Windows users may encounter issues with command-line setups and are directed toward Docker as an alternative. Docker file output depends on a correctly mounted host directory, valid platform-specific paths, and permission for Docker to access that directory. The server does not provide a hosted endpoint or describe authentication requirements.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mindmap MCP Server

Install the PyPI package with pip or launch it with uvx using `uvx mindmap-mcp-server`. Node.js is also required when using pip or uvx.

Yes. The README provides Claude Desktop configuration examples using uvx, Python, and Docker. Restart Claude Desktop after changing its configuration.

Configure the server with `--return-type filePath`, or use the documented file conversion tool. Docker users must mount a host directory to `/output`.

Yes. Use `--return-type html` or the `markdown-to-mindmap-content` tool to return the complete HTML content.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMindmap MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yuchenssr-mindmap-mcp-server?style=directory)](https://allmcps.com/mcp/yuchenssr-mindmap-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/yuchenssr-mindmap-mcp-server"><img src="https://allmcps.com/api/badge/yuchenssr-mindmap-mcp-server?style=directory" alt="Mindmap MCP Server on AllMCPs" /></a>