Для чего этот сервер?

Этот MCP-сервер превращает Markdown-текст в интерактивную интеллект-карту. Он решает задачу визуализации структурированных заметок, планов или конспектов — вместо плоского текста получается наглядная схема, которую можно зумить, сворачивать узлы и сохранять как картинку. Полезен всем, кто работает с большими объёмами информации и хочет быстро увидеть связи между идеями.

Что он умеет?

Конвертирует Markdown в интерактивную ментальную карту, сохраняет её как HTML, по желанию экспортирует в PNG, JPG и SVG и открывает в браузере. Управляет готовыми файлами: показывает список markmap* файлов в выходной папке от новых к старым, возвращает файл по абсолютному пути и удаляет их, с опцией dryRun для защиты от необратимого удаления.

Каталог MCP
jinzcdev/markmap-mcp-server

jinzcdev/markmap-mcp-server

от jinzcdev

Сервер Markmap MCP преобразует Markdown в интерактивные mind map с экспортом в PNG, JPG и SVG. Помогает визуализировать конспекты и структурировать заметки разработчикам и авторам.

Github NPM Сайт сервера

README

4 инструмента

Версии

Установить сервер

Markmap MCP Server

Sample Mindmap

GitHub License

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

Часто задаваемые вопросы

Инструменты были проиндексированы: 18.10.2026

cleanup_mindmapsидемпотентный

Навсегда удаляет файлы markmap* из выходного каталога. ОПАСНО и необратимо, когда dryRun равен false. dryRun по умолчанию равен false: если его не указать, файлы БУДУТ удалены. Всегда вызывайте один раз с dryRun=true для предпросмотра, затем ещё раз с dryRun=false для применения. Перед этим лучше вызвать list_mindmaps. Возвращает {"deleted":["<path>",...],"kept":<n>}; ответы в режиме dryRun также содержат dryRun:true и не удаляют файлы. Используйте вместо ручного удаления файлов, когда подчищаете старые сгенерированные интеллект-карты.

Параметры

allboolean
Если true, удаляет все файлы markmap* в выходном каталоге (игнорирует maxAgeDays). По умолчанию false.
dryRunboolean
Если true, выполняет предпросмотр удалений, не удаляя файлы. По умолчанию false (фактически удаляет). Предпочтительно true при первом вызове.
maxAgeDaysnumber
Удаляет файлы старше указанного количества дней (по умолчанию: 7). Игнорируется, когда all=true.

get_mindmapтолько чтениеидемпотентный

Получает файл сгенерированной ментальной карты по абсолютному пути. Только чтение, без побочных эффектов. Разрешены только пути внутри настроенной директории вывода (выход за её пределы запрещён). Возвращает JSON {"filePath","mimeType","size"}. Для text/html или image/svg+xml размером до 200 КБ также добавляет блок текстового содержимого. PNG/JPG возвращают только метаданные (без блока изображения): если агенту нужны пиксели, повторно экспортируйте через markdown_to_mindmap с format=png|jpg. При ошибке: isError:true и {"error":"Failed to retrieve mind map","message"}. Сначала вызовите list_mindmaps, чтобы получить корректный filePath. Если файл уже существует, используйте этот инструмент вместо повторной генерации.

Параметры

filePathstringобязательный
Абсолютный путь из list_mindmaps (должен оставаться внутри серверной выходной директории).

list_mindmapsтолько чтениеидемпотентный

Выводит список файлов markmap* (html/png/jpg/jpeg/svg) в выходном каталоге, сначала новые. Только чтение, без побочных эффектов. Если каталог отсутствует или пуст, возвращает {"files":[]}. Возвращает: {"outputDir","files":[{"name","filePath","size","mtimeMs","mtime"}]} (mtime в формате ISO 8601). Используется перед get_mindmap для поиска путей или перед cleanup_mindmaps для просмотра целей. Не предназначен для создания новых ментальных карт (для этого используйте markdown_to_mindmap).

Параметры

limitinteger
Максимальное количество файлов для возврата (по умолчанию: 20, максимум: 200). При усечении сохраняются самые новые файлы.

markdown_to_mindmap

Преобразовать Markdown-документ в интерактивную ментальную карту

Параметры

filenamestring
Выводит только базовое имя (без каталогов). Опускает для markmap-<timestamp>. Пользовательские имена получают префикс markmap-, если это нужно, чтобы список/очистка могли их найти. Одинаковое имя перезаписывается.
formatenum
Формат вывода (по умолчанию: html). Используйте html для интерактивного просмотра; png/jpg/svg, когда агенту или пользователю нужно изображение (требуется Playwright).
inputPathstring
Абсолютный путь к локальному файлу .md. Предпочтителен по сравнению с markdown, когда содержимое уже находится на диске и превышает 1 КБ (экономит токены). Игнорируется, если также указан markdown.
markdownstring
Полная строка документа Markdown (не путь к файлу). Предпочитает заголовки ATX (# ## ###) и вложенные списки. Предоставляет это или inputPath (требуется хотя бы одно). Если заданы оба, markdown имеет приоритет.

`0.2.0`основная	04.08.2026
`0.1.1`	06.05.2025
`0.1.0`	05.05.2025

Выберите клиент, чтобы установить jinzcdev/markmap-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"jinzcdev-markmap-mcp-server-4zsijsxf7x\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@jinzcdev/markmap-mcp-server\"],\"env\":{\"MARKMAP_DIR\":\"/path/to/output/directory\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add jinzcdev-markmap-mcp-server-4zsijsxf7x --env MARKMAP_DIR=/path/to/output/directory -- npx -y @jinzcdev/markmap-mcp-server

Либо через JSON-конфиг:

claude mcp add-json jinzcdev-markmap-mcp-server-4zsijsxf7x "{\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@jinzcdev/markmap-mcp-server\"],\"env\":{\"MARKMAP_DIR\":\"/path/to/output/directory\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add jinzcdev-markmap-mcp-server-4zsijsxf7x --env MARKMAP_DIR=/path/to/output/directory -- npx -y @jinzcdev/markmap-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.jinzcdev-markmap-mcp-server-4zsijsxf7x]
command = "npx"
args = ["-y", "@jinzcdev/markmap-mcp-server"]

[mcp_servers.jinzcdev-markmap-mcp-server-4zsijsxf7x.env]
MARKMAP_DIR = "/path/to/output/directory"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите jinzcdev/markmap-mcp-server, а в поле команды запуска — строку ниже:

npx -y @jinzcdev/markmap-mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "jinzcdev-markmap-mcp-server-4zsijsxf7x": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например jinzcdev-markmap-mcp-server-4zsijsxf7x.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: jinzcdev-markmap-mcp-server-4zsijsxf7x
    command: npx
    args:
      - "-y"
      - "@jinzcdev/markmap-mcp-server"
    env:
      MARKMAP_DIR: /path/to/output/directory

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx