Mindmap MCP Server

Name: Mindmap MCP Server
Author: YuChenSSR

@YuChenSSR

Repository

About Mindmap MCP Server

mindmap, mcp server, artifact

#mindmap #artifact #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mindmap MCP Server?

A Model Context Protocol (MCP) server that converts Markdown content into interactive mindmaps using the markmap-cli library. It is intended for users who want to quickly visualize hierarchical Markdown data as mindmaps within MCP‑compatible AI clients.

How to use Mindmap MCP Server?

Install with pip install mindmap-mcp-server, or run with uvx mindmap-mcp-server, or use the Docker image ychen94/mindmap-converter-mcp. Configure in claude_desktop_config.json using uvx, python, or docker commands. Use the --return-type argument to choose between returning the full HTML content (html) or saving the mindmap to a file and returning its path (filePath).

Key features of Mindmap MCP Server

Converts Markdown to interactive mindmap HTML
Option to create offline‑capable mindmaps
Option to hide the toolbar on the mindmap
Returns either HTML content or file path
Works with any MCP‑compatible client
Installation via pip, uvx, or Docker

Use cases of Mindmap MCP Server

Visualize project planning outlines as interactive mindmaps
Summarize research notes or meeting notes in mindmap form
Generate mindmaps for documentation or learning materials
Save tokens by generating a mindmap file instead of returning the full HTML
Automate mindmap creation within AI‑powered workflows

FAQ from Mindmap MCP Server

What alternatives are available if this server doesn’t work?

For Windows users or those with persistent issues, the README suggests using the “Markmap” VS Code extension or a provided system prompt that generates markmap HTML directly.

What are the runtime dependencies?

The server requires Node.js when installed via pip or run with uvx. The Docker method avoids this dependency.

How do I choose between returning HTML and a file path?

Use the --return-type argument: html returns the full mindmap HTML (good for preview in an AI client’s artifact), while filePath saves the mindmap to a file and returns the path (saves tokens and allows later opening in a browser).