Markmap MCP Server MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Единый инструмент markdown-to-mindmap — добавьте Markdown и получите визуализированное дерево.
Интерактивный вывод: масштабирование, панорамирование, развертывание/свертывание узлов.
Экспорт в PNG/JPG/SVG с визуализированной страницы.
Автооткрытие в браузере по умолчанию (необязательно)
MARKMAP_DIR env var для управления выходными данными

Живое демо

Как выглядит на практике

markmap-mcp-server.replay ▶ готово

0/0

Установка

Выберите клиент

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

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "markmap-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "markmap-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jinzcdev/markmap-mcp-server"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Markmap MCP Server

Превратите заметки о встречах в интеллектуальную карту для быстрого обмена ими

👤 Менеджеры по проектам и руководители групп синхронизируют большое количество заметок ⏱ ~10 min beginner

Когда использовать: После встречи, когда плоский список скрывает суть обсуждения.

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

Узел 18+ — установка нвм 18

Поток

Попросите агента составить проект Markdown

Подведите итоги сегодняшнего совещания по планированию в виде вложенного плана Markdown с темами верхнего уровня.✓ Скопировано

→ В схеме есть 3–5 основных тем и вложенные подпункты.
Оказывать

Запустите markdown-to-mindmap по этому контуру, откройте в браузере.✓ Скопировано

→ Открывается интерактивная карта разума; узлы свернуть/развернуть
Экспорт

Экспортируйте карту в SVG и поместите файл в документ команды.✓ Скопировано

→ SVG сохранен в MARKMAP_DIR.

Итог: Общая интеллектуальная карта, которая кодирует форму встречи, а не только ее слова.

Подводные камни

Контур слишком мелкий — все становится узлом верхнего уровня. — Принудительное вложение: запросите темы → подпункты → подтверждающие факты.

Сочетать с: filesystem

Создайте учебную карту на основе главы учебника.

👤 Студенты и учащиеся на протяжении всей жизни ⏱ ~20 min beginner

Когда использовать: Вы прочитали главу и хотите получить наглядное изображение в виде одного изображения, которое можно просмотреть перед экзаменом.

Поток

Подведите итоги главы

Обобщите главу 4 <book> в виде иерархической структуры Markdown.✓ Скопировано

→ Очистить дерево тем
Рендеринг и экспорт

Создайте интеллектуальную карту и сохраните ее в формате PNG в ~/study/.✓ Скопировано

→ PNG-файл готов к рассмотрению

Итог: Визуальное учебное пособие, сканирование которого занимает несколько секунд.

Сочетать с: paper-fetch-skill

Прежде чем писать полную схему, нарисуйте неформальную карту архитектуры.

👤 Инженеры рисуют эскизы перед тем, как приступить к рисованию.io/figma ⏱ ~15 min intermediate

Когда использовать: Вам нужна двухминутная диаграмма «обсуждения», а не отточенный архитектурный документ.

Поток

Получение списка сервисов в Markdown

Опишите сервисы в этом репозитории как вложенное дерево Markdown, сгруппированное по домену.✓ Скопировано

→ Сгруппированная структура отражает структуру кодовой базы.
Оказывать

Превратите его в интеллект-карту и экспортируйте в SVG.✓ Скопировано

→ SVG вы можете закинуть в проектный документ.

Итог: Диаграмма разговорного трека за считанные минуты; перейти к реальной схеме архитектуры позже, только если это необходимо.

Подводные камни

Рассматривая его как последний артефакт — Используйте его как инструмент мышления; заменить формальной схемой перед публикацией

Сочетать с: mermaid-skill

Комбинации

Сочетайте с другими MCP — эффект x10

markmap-mcp-server + filesystem

Прочитайте длинный документ, подведите итоги в виде схемы Markdown, отобразите в виде карты связей.

Прочтите ./notes/long-doc.md, создайте вложенный план, а затем отобразите его в виде карты связей.✓ Скопировано

markmap-mcp-server + mermaid-skill

Выберите правильный визуальный элемент — русалка для потоков, карта разметки для иерархий.

Решите, будет ли это поток (русалка) или иерархия (карта меток), и выполните рендеринг соответственно.✓ Скопировано

markmap-mcp-server + paper-fetch-skill

Получите аннотацию/разделы статьи, сопоставьте структуру аргументов.

Возьмите статью, извлеките заголовки разделов и ключевые моменты, представьте аргумент в виде карты мыслей.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
markdown-to-mindmap	markdown: str, open?: bool	Преобразование вложенного контура Markdown в интерактивную карту связей	0

Стоимость и лимиты

Во что обходится

Квота API: Нет — рендеринг локальный.
Токенов на вызов: Маленький: размер контура
Деньги: Бесплатно
Совет: Для удобства чтения оставляйте контуры примерно в 100 узлах; Карты большего размера медленно панорамируются/экспортируются.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Нет учетных данных — рендеринг в автономном режиме

Исходящий трафик: Нет выхода из сети. Шрифты и JS включены локально.

Если вы установите MARKMAP_DIR внутри репозитория git, сгенерированные файлы HTML/PNG могут быть зафиксированы; добавьте выходной каталог в .gitignore.

Устранение неполадок

Частые ошибки и исправления

Браузер не открылся

Установите open=false и откройте возвращенный путь HTML вручную; убедитесь, что браузер по умолчанию зарегистрирован.

Проверить: open $(returned_path) on macOS

Экспортированный PNG пуст.

Перед экспортом подождите секунду, пока карта полностью отрендерится. Увеличьте задержку в конфигурации или запустите экспорт дважды.

Проверить: Open the HTML in a browser and check it renders before export

В разрешении отказано на запись в MARKMAP_DIR

Укажите MARKMAP_DIR на доступный для записи путь в вашем домашнем каталоге.

Проверить: touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

Альтернативы

Markmap MCP Server в сравнении

Альтернатива	Когда использовать	Компромисс
mermaid-skill	Ваши данные — это поток или последовательность, а не иерархия.	Другая парадигма диаграммы
excalidraw-skill	Вам нужны нарисованные от руки схематичные визуальные эффекты	Нет автоматической раскладки; ручное позиционирование
antv-chart	Вам нужны статистические диаграммы, а не интеллект-карты	Другой класс вывода

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills