Markdown Mindmap Converter MCP Server

Overview

The Markdown Mindmap Converter is a Model Context Protocol (MCP) server that transforms Markdown content into interactive, visual mindmaps. This tool helps you visualize hierarchical information in a more intuitive and engaging format.

Installation Options

You have three ways to install and use the Markdown Mindmap Converter:

1. Using uvx (Recommended)

uvx mindmap-mcp-server

2. Using pip

pip install mindmap-mcp-server

3. Using Docker (Most reliable across platforms)

docker pull ychen94/mindmap-converter-mcp

Note for Windows Users: If you experience issues with the npx command when using this MCP, consider using the Docker method or the "Markmap" extension for Visual Studio Code.

Configuration

Add the server to your MCP client configuration (e.g., claude_desktop_config.json):

Using uvx (Recommended)

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

Using Python

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

Using Docker

{
  "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 mindmaps, such as /Users/username/Downloads on macOS or C:\\Users\\username\\Downloads on Windows.

Return Type Options

The --return-type parameter determines how the mindmap is delivered:

• html: Returns the entire HTML content of the mindmap, which you can preview directly in your AI client's artifact viewer.
• filePath: Saves the mindmap to a file and returns the file path. This option saves tokens and is recommended for complex mindmaps.

Usage Examples

In your AI assistant, you can use prompts like:

1. Basic mindmap generation:

   Give a mindmap for the following markdown code, using a mindmap tool:
   
   # Project Planning
   ## Research
   ### Market Analysis
   ### Competitor Review
   ## Design
   ### Wireframes
   ### Mockups
   

2. Generate and open in browser (if using with another MCP like 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:
   
   # Your Markdown Content Here
   

3. Conceptual mindmap:

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

Troubleshooting

File Not Found

• Verify that you've correctly mounted a volume to the Docker container
• Ensure the path format is correct for your operating system
• Make sure Docker has permission to access the directory

Docker Command Not Found

• Verify Docker is installed and in your PATH
• Try using the absolute path to Docker

Server Not Appearing in Claude

• Restart Claude for Desktop after configuration changes
• Check Claude logs for connection errors
• Verify Docker is running

Prerequisites

When using the Python or uvx installation methods, Node.js must be installed on your system for the markmap-cli dependency to work properly.