/ Каталог / Песочница / Markmap MCP Server
● Сообщество jinzcdev ⚡ Сразу

Markmap MCP Server

автор jinzcdev · jinzcdev/markmap-mcp-server

Превратите любой контур Markdown в интерактивную интеллектуальную карту с помощью одного вызова инструмента — панорамирование, свертывание, экспорт PNG/JPG/SVG.

markmap-mcp-server оборачивает средство визуализации карты разметки с открытым исходным кодом в качестве инструмента MCP. Наполните его Markdown вложенными заголовками или списками маркеров, получите интеллектуальную карту HTML, которая открывается в вашем браузере (запускается автоматически) и экспортируется в PNG / JPG / SVG. Полезно для подведения итогов совещаний, мозговых штурмов, учебных заметок и в любое время, когда плоский контур легче представить в виде дерева.

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

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

Живое демо

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

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
Поток
  1. Попросите агента составить проект Markdown
    Подведите итоги сегодняшнего совещания по планированию в виде вложенного плана Markdown с темами верхнего уровня.✓ Скопировано
    → В схеме есть 3–5 основных тем и вложенные подпункты.
  2. Оказывать
    Запустите markdown-to-mindmap по этому контуру, откройте в браузере.✓ Скопировано
    → Открывается интерактивная карта разума; узлы свернуть/развернуть
  3. Экспорт
    Экспортируйте карту в SVG и поместите файл в документ команды.✓ Скопировано
    → SVG сохранен в MARKMAP_DIR.

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

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

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

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

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

Поток
  1. Подведите итоги главы
    Обобщите главу 4 <book> в виде иерархической структуры Markdown.✓ Скопировано
    → Очистить дерево тем
  2. Рендеринг и экспорт
    Создайте интеллектуальную карту и сохраните ее в формате PNG в ~/study/.✓ Скопировано
    → PNG-файл готов к рассмотрению

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

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

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

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

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

Поток
  1. Получение списка сервисов в Markdown
    Опишите сервисы в этом репозитории как вложенное дерево Markdown, сгруппированное по домену.✓ Скопировано
    → Сгруппированная структура отражает структуру кодовой базы.
  2. Оказывать
    Превратите его в интеллект-карту и экспортируйте в 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 включены локально.

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

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

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

Установите 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