Markmap MCP Server

Markmap MCP Server

Convert Markdown to interactive mind maps via the Model Context Protocol.

137
Stars
22
Forks
137
Watchers
4
Issues
Markmap MCP Server enables seamless conversion of Markdown content into interactive mind maps using the Model Context Protocol (MCP). It leverages the open-source markmap project and provides users with diverse export formats including PNG, JPG, and SVG. Designed for easy integration with MCP clients, it offers tools for automated browser previews, rich interactivity, and batch mind map generation. The server can be installed easily via npm or Smithery and supports configurable output directories.

Key Features

Convert Markdown to interactive mind maps
Export mind maps as PNG, JPG, and SVG images
Interactive operations such as zooming, expanding, and collapsing nodes
Automatic browser preview of generated mind maps
One-click copy of original Markdown content
Easy setup via npm and Smithery
Supports environment variable and CLI-configured output directories
Integrates with MCP clients using stdio interface
Batch conversion capabilities
Supports localization (e.g., Chinese documentation)

Use Cases

Visualizing notes or documents written in Markdown
Integrating automated mind map generation into AI applications via MCP
Exporting mind maps for presentations or publishing
Enhancing productivity tools with instant mind map rendering
Curriculum or project planning using mind maps
Enabling team knowledge sharing with visual outlines
Automated content processing pipelines for knowledge management
Educational tools that require Markdown-to-mind map visualization
Personal knowledge base visualization
Interactive exploration and organization of complex concepts

README

Markmap MCP Server

Sample Mindmap

NPM Version GitHub License Smithery Badge 中文文档 Stars

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

Installing via Smithery

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

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

Manual Installation

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

markdown-to-mindmap

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.

Star History

Star History Chart

Repository Owner

jinzcdev
jinzcdev

User

Repository Details

Language TypeScript
Default Branch main
Size 200 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
77.66%
JavaScript
17.77%
Dockerfile
4.57%

Tags

Topics

ai llm markmap mcp mcp-server mindmap mindnode xmind

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • piapi-mcp-server

    piapi-mcp-server

    TypeScript-based MCP server for PiAPI media content generation

    piapi-mcp-server is a TypeScript implementation of a Model Context Protocol (MCP) server that connects with PiAPI to enable media generation workflows from MCP-compatible applications. It handles image, video, music, TTS, 3D, and voice generation tasks using a wide range of supported models like Midjourney, Flux, Kling, LumaLabs, Udio, and more. Designed for easy integration with clients such as Claude Desktop, it includes an interactive MCP Inspector for development, testing, and debugging.

    • 62
    • MCP
    • apinetwork/piapi-mcp-server
  • Typst MCP Server

    Typst MCP Server

    Facilitates AI-driven Typst interactions with LaTeX conversion, validation, and image generation tools.

    Typst MCP Server implements the Model Context Protocol, enabling AI models to interface seamlessly with Typst, a markup-based typesetting system. It provides tools for tasks such as converting LaTeX to Typst, validating Typst syntax, listing and retrieving Typst documentation chapters, and rendering Typst code as images. The server is compatible with MCP agent clients, such as Claude Desktop and VS Code’s agent mode. All functionalities are exposed as tools for ease of LLM integration.

    • 79
    • MCP
    • johannesbrandenburger/typst-mcp
  • 文颜 MCP Server (Wenyan MCP Server)

    文颜 MCP Server (Wenyan MCP Server)

    AI-powered tool for publishing and formatting Markdown articles to WeChat official accounts via MCP.

    文颜 MCP Server is a server component based on the Model Context Protocol (MCP) that enables automated publishing and formatting of Markdown articles to the WeChat Official Account drafts. It integrates with AI tools and leverages a theming system shared with other Wenyan products to beautify content. The tool is designed for multi-platform use and supports integration with local, CI/CD, and Docker-based AI toolchains, offering seamless automation for article management and publication.

    • 907
    • MCP
    • caol64/wenyan-mcp
  • Jotdown

    Jotdown

    MCP Server for Notion Page Creation and mdBook Generation

    Jotdown is an MCP server enabling large language models to interact seamlessly with Notion and generate markdown books (mdBooks). It allows LLMs to create or update Notion pages and manage the entire process of markdown book creation, including structure and navigation. Leveraging the Model Context Protocol, it provides tools for consistent and intelligent context handling between LLMs and external content platforms.

    • 19
    • MCP
    • Harry-027/JotDown
  • Replicate Flux MCP

    Replicate Flux MCP

    MCP-compatible server for high-quality image and SVG generation via Replicate models.

    Replicate Flux MCP is an advanced Model Context Protocol (MCP) server designed to enable AI assistants to generate high-quality raster images and vector graphics. It leverages Replicate's Flux Schnell model for image synthesis and Recraft V3 SVG model for vector output, supporting seamless integration with AI platforms like Cursor, Claude Desktop, Smithery, and Glama.ai. Users can generate images and SVGs by simply providing natural language prompts, with support for parameter customization, batch processing, and variant creation.

    • 66
    • MCP
    • awkoy/replicate-flux-mcp
  • VictoriaMetrics MCP Server

    VictoriaMetrics MCP Server

    Model Context Protocol server enabling advanced monitoring and observability for VictoriaMetrics.

    VictoriaMetrics MCP Server implements the Model Context Protocol (MCP) to provide seamless integration with VictoriaMetrics, allowing advanced monitoring, data exploration, and observability. It offers access to almost all read-only APIs, as well as embedded documentation for offline usage. The server facilitates comprehensive metric querying, cardinality analysis, alert and rule testing, and automation capabilities for engineers and tools.

    • 87
    • MCP
    • VictoriaMetrics-Community/mcp-victoriametrics
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results