Markmap MCP Server

!Sample Mindmap


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 (v20 or above)

Installation

$3

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

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

$3

`bash


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
`

Alternatively, you can clone the repository and run locally:

`bash


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
`

Usage

Add the following configuration to your MCP client configuration file:

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

> [!TIP]
>
> The service supports the following environment variables:
>
> - MARKMAP_DIR: Specify the output directory for mind maps (optional, defaults to system temp directory)
>
> Priority Note:
>
> When both the --output command line argument and the MARKMAP_DIR environment variable are specified, the command line argument takes precedence.

Available Tools

$3

Convert Markdown text into an interactive mind map.

Parameters:

- markdown: The Markdown content to convert (required string)
- open: Whether to automatically open the generated mind map in the browser (optional boolean, default is false)

Return Value:

`json
{
"content": [
{
"type": "text",
"text": "JSON_DATA_OF_MINDMAP_FILEPATH"
}
]
}
``

License

This project is licensed under the MIT License.