Overview
A Model Context Protocol (MCP) server for converting Markdown content to interactive mindmaps. It can be run by installing via pip (mindmap-mcp-server) or using uvx/Python, or via Docker. The server leverages markmap tooling to render Markdown as interactive HTML mindmaps, with options for offline-capable mindmaps and toolbar visibility. In Docker, it provides two MCP tools: markdown-to-mindmap-content, which converts Markdown to an HTML mindmap and returns the full HTML content, and markdown-to-mindmap-file, which converts Markdown and saves the mindmap to a file in a mounted directory. Parameters include markdown (required) and toolbar (optional). Return type can be html or filePath, configurable via --return-type, enabling either immediate HTML content preview or a saved file path. Prerequisites include Node.js when using Python or uvx to run the server. MCP v1.0 specification is implemented. Usage examples cover Claude Desktop and other MCP clients, with Docker and Python deployment details. The server supports macOS and Linux; Windows users may prefer Docker. Troubleshooting guidance is provided in the README.
Features
Convert Markdown to interactive mindmap HTML
Generates an HTML mindmap from Markdown content using markmap tooling.
Offline-capable mindmaps
Option to create HTML mindmaps that can be used without an online connection or saved as files.
Hide toolbar option
Ability to hide the mindmap toolbar for a cleaner visualization.
Return HTML content or file path
Return either the full HTML content or the path to a saved mindmap file via MCP return-type.
Who Is This For?
- MCP clients:Convert Markdown content to mindmaps via MCP clients, returning HTML or file paths.
