# YuChenSSR/mindmap-mcp-server [Health: Active]

**Category:** 📊 Data Visualization  
**Repository:** https://github.com/YuChenSSR/mindmap-mcp-server  
**GitHub Stars:** 237  
**npm Downloads (last month):** 49  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yuchenssr-mindmap-mcp-server

## Description
A Model Context Protocol (MCP) server for generating a beautiful interactive mindmap.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mindmap-mcp-server": {
    "command": "uvx",
    "args": ["mindmap-mcp-server"]
  }
}
```

## Documentation

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

_Full upstream README: https://allmcps.com/mcp/yuchenssr-mindmap-mcp-server/readme_