Markmap MCP Server

Markmap MCP Server is based on the Model Context Protocol (MCP) that allows one-click conversion of Markdown text to interactive mind maps, built on the open source project markmap. The generated mind maps support rich interactive operations and can be exported in various image formats.

🎉 Explore More Mind Mapping Tools

Try MarkXMind - An online editor that creates complex mind maps using simple XMindMark syntax. It supports real-time preview, multi-format export (.xmind/.svg/.png), importing existing XMind files. Try it now!

Features

• 🌠 Markdown to Mind Map: Convert Markdown text to interactive mind maps
• 🖼️ Multi-format Export: Support for exporting as PNG, JPG, and SVG images
• 🔄 Interactive Operations: Support for zooming, expanding/collapsing nodes, and other interactive features
• 📋 Markdown Copy: One-click copy of the original Markdown content
• 🌐 Automatic Browser Preview: Option to automatically open generated mind maps in the browser

Prerequisites

1. Node.js (v25)

Installation

Manual Installation

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

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

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

# Or
markmap-mcp-server

Alternatively, you can clone the repository and run locally:

# Clone the repository
git clone https://github.com/isdmx/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

Usage

Add the following configuration to your MCP client configuration file:

{
  "mcpServers": {
    "default-server": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
    }
  }
}

Install inspector @modelcontextprotocol/inspector

npm install -g @modelcontextprotocol/inspector

List tools with inspector

mcp-inspector --cli --transport http --method tools/list --server-url --target http://localhost:3000/mcp

Call markdown-to-mindmap tool

mcp-inspector --cli --transport http --method tools/call --server-url --target http://localhost:3000/mcp --tool-name markdown_to_mindmap --tool-arg markdown="
# header 1
## Header 1.1
- [x] ul 1
- [ ] ul 2
- [ ] ul 3
## Header 1.2
- bullet 1
- bullet 2
## Header 1.3
### Header 1.3.1
### Header 1.3.2
1. ol 1
2. ol 2
3. ol 3
"

Available Tools

markdown-to-mindmap

Convert Markdown text into an interactive mind map.

Parameters:

• markdown: The Markdown content to convert (required string)

Return Value:

{
  "tools": [
    {
      "name": "markdown_to_mindmap",
      "title": "Markdown to Mind Map Converter",
      "description": "Converts Markdown content to an interactive HTML mind map",
      "inputSchema": {
        "type": "object",
        "properties": {
          "markdown": {
            "type": "string",
            "description": "Markdown content to convert into a mind map"
          }
        },
        "required": ["markdown"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "html": {
            "type": "string",
            "description": "HTML content of the generated mind map"
          },
          "contentLength": {
            "type": "number",
            "description": "Length of the HTML content"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the conversion was successful"
          },
          "error": {
            "type": "string",
            "description": "Error message if conversion failed"
          }
        },
        "required": ["html", "contentLength", "success"],
        "additionalProperties": false
      }
    }
  ]
}

License

This project is licensed under the MIT License.