Mind Map

Locally generate mind maps from Markdown with a fully private, zero-dependency MCP server.

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sawyer-shi-mind-map-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/mind-map-mcp/server.py",
        "stdio"
      ]
    }
  }
}

You can run a fully local Model Context Protocol (MCP) server to generate beautiful mind map images from Markdown text. It works completely offline, with data staying on your machine, and supports multiple transport methods so you can connect from local tools or remote clients.</intro

How to use

To generate mind maps, connect your MCP client to the Mind Map MCP Server using one of the supported transport methods. You can run the server locally for fast iteration or use a remote-ready setup for remote connections. The server converts Markdown headers and lists into structured mind map hierarchies and outputs PNG images encoded in Base64 for easy embedding.

How to install

Prerequisites: you need Python installed on your system. You may also use a Python-based package manager if you prefer.

Quick Install (Recommended) Run the installation steps to automatically configure everything.

# Clone the repository first
git clone https://github.com/sawyer-shi/mind-map-mcp.git
cd mind-map-mcp

# Run the installation script
python install.py

The script will install dependencies, generate the MCP configuration, and save it to your MCP settings.

Manual Installation 1. Install dependencies 2. Configure MCP server manually 3. Start the server using your preferred transport.

# Install dependencies
pip install -r requirements.txt

{
  "mcpServers": {
    "mind-map": {
      "command": "python",
      "args": [
        "/absolute/path/to/mind-map-mcp/server.py",
        "stdio"
      ]
    }
  }
}

Configuration and security notes

The Mind Map MCP Server is designed for complete local deployment with no external services or API keys. All data stays on your machine unless you explicitly configure remote transport, ensuring maximum privacy and security.

Transport options let you run locally or connect remotely. The standard stdio transport is best for local use, while the streamable HTTP transport is recommended for remote connections.

Examples and usage tips

Tools available for generating specific mind map layouts include radial, horizontal, and smart auto layouts. Use the dedicated tools to produce the layout that best fits your Markdown content.

Available tools

create_center_mindmap

Generates a radial mind map from Markdown content, suitable for core concepts and brainstorming.

create_horizontal_mindmap

Generates a left-to-right mind map layout, ideal for timelines, processes, and hierarchical structures.

create_free_mindmap

Generates a mind map using an automatic layout selection based on content complexity.