Markmap

An MCP server for converting Markdown to interactive mind maps with export support (PNG/JPG/SVG).

typescript

170

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks 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": {
    "jinzcdev-markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "YOUR_OUTPUT_DIRECTORY"
      }
    }
  }
}

Markmap MCP Server converts Markdown text into interactive mind maps using the MCP protocol. It lets you generate rich, zoomable mind maps from Markdown content and export them in multiple image formats, with automatic browser previews if you choose.

How to use

You use Markmap MCP Server by connecting an MCP client that can start a stdio server process. The client sends Markdown content to the server and receives a mind map in return. You can specify whether to open the mind map in a browser and you can export the result as images. To run locally, start the server via a command line tool and point your client to it.

How to install

Prerequisites: you need Node.js version 20 or higher.

Install via Smithery to integrate with Claude Desktop automatically:

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude

Manual installation options include installing from npm and running the server directly, or cloning the repository and building locally.

# Install from npm
npm install @jinzcdev/markmap-mcp-server -g

# Basic run
npx -y @jinzcdev/markmap-mcp-server

# Specify output directory
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory

If you prefer to run from source, clone the project, install dependencies, build, and start the server locally.

# Clone the repository
git clone https://github.com/jinzcdev/markmap-mcp-server.git

# Navigate to the project directory
cd markmap-mcp-server

# Build project
npm install && npm run build

# Run the server
node build/index.js

Additional configuration and usage notes

Configure your MCP client to invoke the Markmap MCP Server as a stdio process. The server can accept a Markdown payload and return a mind map file path in its response.

Environment variable overview for the running server: you can set MARKMAP_DIR to specify the output directory for mind maps. If both the --output argument and MARKMAP_DIR are provided, the command line argument takes precedence.

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      }
    }
  }
}

Available tools

markdown-to-mindmap

Converts Markdown text into an interactive mind map that can be viewed in a browser and exported as images.