Markmap

🚀 Markmap MCP Server

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

✨ Features

• 🌠 Markdown to Mind Map Conversion: Convert Markdown text into interactive mind maps.
• 🖼️ Multi - format Export: Support exporting in PNG, JPG, and SVG image formats.
• 🔄 Interactive Operations: Support zooming, expanding/collapsing nodes, and other interactive features.
• 📋 Markdown Copy: Copy the original Markdown content with one click.
• 🌐 Automatic Browser Preview: Option to automatically open the generated mind map in the browser.

📦 Installation

Prerequisites

1. Node.js runtime environment

Installation via Smithery

To automatically install the Markmap MCP Server for Claude Desktop via Smithery:

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

Manual Installation

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

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

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

Alternatively, you can clone the repository and run it locally:

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

# Enter the project directory
cd markmap-mcp-server

# Build the project
npm install && npm run build

# Run the server
node build/index.js

🚀 Quick Start

Add the following configuration to your MCP client configuration file:

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

⚠️ Important Note

This service supports the following environment variables:

• MARKMAP_DIR: Specify the output directory for mind maps (optional, default is the system temporary directory).

Priority Explanation:

When both the --output command - line parameter and the MARKMAP_DIR environment variable are specified, the command - line parameter takes precedence.

💻 Usage Examples

Basic Usage

Install Dependencies

npm install @jinzcdev/markmap-mcp-server

Example Configuration File

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  }
}

Usage Example

npx @jinzcdev/markmap-mcp-server

🔗 Code Repository

GitHub - markmap-mcp-server

👥 Contributors

• Jin ZC

📄 License

MIT License