Markmap MCP Server основан на протоколе Model Context Protocol (MCP). Он преобразует Markdown в интерактивные интеллектуальные карты с помощью markmap и может по желанию экспортировать PNG / JPG / SVG на сервер для удобной доставки с агентом. Генерация работает локально — не требуются сторонние API-ключи.

Особенности

• Markdown → Mind Map: Преобразовать Markdown (заголовки + вложенные списки) в интерактивные HTML-ментальные карты
• Агент-дружественные возвраты: Возвращают путь к файлу, встроенный HTML и/или содержимое изображения (настроено при запуске)
• Экспорт на сторону сервера: Экспорт PNG / JPG / SVG через Playwright для чата/онлайн-превью
• Браузерный предварительный просмотр: Настраиваемое открытое поведение — всегда, никогда, или решаемое агентом (настройка запуска)
• Панель инструментов для экспорта браузера: При просмотре HTML также экспортируйте PNG/JPG/SVG или скопируйте Markdown в интерфейсе страницы
• Офлайн HTML: Запускайте [--offline встроенные ассеты, чтобы страница работала без доступа к CDN
• Рабочие процессы файлов: Чтение из inputPath, список недавних выходов, очистка старых файлов
• Конфиденциальность: полностью локальное преобразование; отсутствие облачного API mindmap

Предварительные требования

1. Node.js v20 или выше
2. Для экспорта изображений на сервере (format: png|jpg|svg): установите Playwright и Chromium

Markmap MCP Server

Markmap MCP Server is based on the Model Context Protocol (MCP). It converts Markdown into interactive mind maps using markmap, and can optionally export PNG / JPG / SVG on the server for Agent-friendly delivery. Generation runs locally — no third-party API keys required.

Features

• Markdown → Mind Map: Convert Markdown (headings + nested lists) to interactive HTML mind maps
• Agent-friendly returns: Return a file path, inline HTML, and/or image content (configured at startup)
• Server-side export: Export PNG / JPG / SVG via Playwright for chat/inline preview
• Browser preview: Configurable open behavior — always, never, or agent-decided (startup setting)
• Browser export toolbar: When viewing HTML, also export PNG/JPG/SVG or copy Markdown in the page UI
• Offline HTML: Startup --offline inlines assets so the page works without CDN access
• File workflows: Read from inputPath, list recent outputs, clean up old files
• Privacy-first: Fully local conversion; no cloud mind-map API

Prerequisites

1. Node.js v20 or above
2. For server-side image export (format: png|jpg|svg): install Playwright and Chromium

npm install playwright
npx playwright install chromium

(playwright is an optional dependency of this package.)

Installation

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

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

# Specify output directory and auto-open in browser
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory --open always

Docker

docker build -t markmap-mcp-server .
docker run --rm -i \
  -v /path/to/output:/data/markmap \
  -e MARKMAP_DIR=/data/markmap \
  markmap-mcp-server

Or clone and run locally:

git clone https://github.com/jinzcdev/markmap-mcp-server.git
cd markmap-mcp-server
npm install && npm run build
# Optional: enable server-side image export
npx playwright install chromium
node build/index.js

Usage

Add the following configuration to your MCP client (Cursor / Claude Desktop / etc.):

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