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

jinzcdev/markmap-mcp-server

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

README

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

Версии

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

Markmap MCP Server

Sample Mindmap

GitHub License

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.

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

Node.js (v20 or above)

Installation

Installing via Smithery

To install Markmap MCP Server for Claude Desktop automatically 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 output directory
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory

Инструменты были проиндексированы: 11.09.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 имеет приоритет.

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

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

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

Нужен npx

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

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

FAQ

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

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

Что он умеет?

Сервер конвертирует структурированный Markdown (заголовки и списки) в интерактивные mind map, по желанию открывает готовую карту в браузере и экспортирует её в PNG, JPG или SVG. Управляет сгенерированными файлами: показывает их список (новые сверху), отдаёт содержимое по пути и удаляет их с возможностью сухого прогона для безопасной проверки.