Сервер Mindmap MCP

Сервер Model Context Protocol (MCP) для преобразования контента Markdown в интерактивные ментальные карты.

Установка

pip install mindmap-mcp-server

Или с помощью uvx :

uvx mindmap-mcp-server

Или использовать docker безопаснее и проще.

Внимание

Три способа установки были успешно протестированы на macOS и Linux.

Для пользователей Windows, испытывающих проблемы с npx для этого MCP, рассмотрите возможность использования метода Docker. В качестве альтернативы, если вы используете Visual Studio Code, расширение "Markmap" предлагает потенциально более простое решение, чем навигация по инструментам командной строки.

Если у вас возникли нерешенные проблемы, вы можете использовать мою недавнюю системную подсказку в качестве помощника по Mindmap вместо использования этого сервера MCP.

You are a specialized assistant that generates HTML code for interactive markdown-based mind maps (markmaps). When a user sends you content, respond with a complete HTML document that displays their content as a markmap visualization.
If artifact tool is turned on, you can use the artifact.

Follow these requirements:
1. Use the markmap-autoloader library (version 0.18 or latest stable version)
2. Format the HTML exactly according to the template below
3. Replace the demo content in the template with the user's content, preserving their hierarchical structure
4. Maintain the markmap configuration options (maxWidth: 300, colorFreezeLevel: 2)
5. If the user doesn't provide markdown formatting (# for headings), format their content appropriately with main topics using # and subtopics using ##

Template to follow:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/markmap-autoloader@0.18"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

Варианты визуализации: (Если формулы или символы отображаются неправильно, загрузите HTML-файл и откройте его в браузере.)

Просмотреть ментальную карту в артефактах (если доступно): $системный\_запрос\_артефакт$
Отобразите HTML-файл в виде ментальной карты: $system\_prompt\_render$

Предпосылки

Для этого пакета требуется установленный Node.js при использовании команды python или uvx для запуска сервера.

Использование

С помощью Claude Desktop или других клиентов MCP

Добавьте этот сервер в ваш claude_desktop_config.json :

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

или

рекомендуется:

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

мы используем --return-type для указания возвращаемого типа содержимого ментальной карты, вы можете выбрать html или filePath в соответствии с вашими потребностями.
html вернет все HTML-содержимое ментальной карты, которое вы можете предварительно просмотреть в артефакте вашего клиента ИИ;

$return\_html\_content$

$html\_preview$

filePath сохранит карту разума в файл и вернет путь к файлу, который вы можете открыть в своем браузере. Он может сохранить ваши токены !

$сгенерировать\_файл$

$файл\_для\_открытия$

Использование определенного файла Python в этом репозитории:

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

или

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

мы используем --return-type для указания типа возвращаемого содержимого ментальной карты, вы можете выбрать html или filePath в соответствии с вашими потребностями. Более подробную информацию см. в разделе «Использование `uvx`».

Сначала вы извлекаете изображение:

docker pull ychen94/mindmap-converter-mcp

Во-вторых, настройте сервер:

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ Замените /path/to/output/folder на фактический путь в вашей системе, где вы хотите сохранять ментальные карты, например /Users/username/Downloads на macOS или C:\\Users\\username\\Downloads на Windows.

Инструменты, предоставляемые в контейнере Docker. Сервер предоставляет следующие инструменты MCP:

markdown-to-mindmap-content
Преобразует Markdown в HTML-карту связей и возвращает весь HTML-контент.
Аргументы: -v и /path/to/output/folder:/output в команде docker не используются.
Параметры :
• markdown (строка, обязательно): содержимое Markdown для преобразования
• панель инструментов (логическое значение, необязательно): показывать ли панель инструментов (по умолчанию: true)
Лучше всего подходит для : Простые карты разума, где размер HTML-контента не имеет значения. И вы можете использовать artifact в вашем AI-клиенте для предварительного просмотра карты разума.
markdown-to-mindmap-файл
Преобразует Markdown в HTML-карту связей и сохраняет ее в файле в смонтированном каталоге.
Параметры :
• markdown (строка, обязательно): содержимое Markdown для преобразования
• имя файла (строка, необязательно): пользовательское имя файла (по умолчанию: автоматически сгенерированное имя временной метки)
• панель инструментов (логическое значение, необязательно): показывать ли панель инструментов (по умолчанию: true)
Подходит для : сложных ментальных карт или когда вы хотите сохранить токены для дальнейшего использования.
вы можете открыть html-файл в вашем браузере, чтобы просмотреть mindmap. Также вы можете использовать iterm-mcp-server или mcp-серверы других терминалов, чтобы открыть файл в вашем браузере, не прерывая рабочий процесс.

Поиск неисправностей

Файл не найден
Если файл вашей ментальной карты недоступен:
1 Проверьте, правильно ли вы смонтировали том в контейнере Docker.
2 Убедитесь, что формат пути соответствует вашей операционной системе.
3 Убедитесь, что у Docker есть разрешение на доступ к каталогу

Команда Docker не найдена
1 Убедитесь, что Docker установлен и находится в вашем PATH
2 Попробуйте использовать абсолютный путь к Docker

Сервер не отображается в Claude
1 Перезапустите Claude for Desktop после изменения конфигурации
2 Проверьте журналы Клода на наличие ошибок подключения
3. Убедитесь, что Docker запущен

Расширенное использование
Использование с другими клиентами MCP
Этот сервер работает с любым MCP-совместимым клиентом, а не только с Claude for Desktop. Сервер реализует спецификацию Model Context Protocol (MCP) версии 1.0.

Функции

Этот сервер предоставляет инструмент для преобразования содержимого Markdown в ментальные карты с использованием библиотеки markmap-cli :

Преобразовать Markdown в интерактивную ментальную карту HTML
Возможность создания оффлайн-карт связей
Возможность скрыть панель инструментов
Возвращает либо HTML-контент, либо путь к файлу

Пример

В Клоде вы можете спросить:

" создайте ментальную карту для следующего кода разметки, используя инструмент ментальных карт:

# Project Planning
## Research
### Market Analysis
### Competitor Review
## Design
### Wireframes
### Mockups
## Development
### Frontend
### Backend
## Testing
### Unit Tests
### User Testing

если вы хотите сохранить ментальную карту в файл, а затем открыть ее в браузере с помощью сервера iTerm MCP:

" создайте ментальную карту для следующего кода разметки input_code с помощью инструмента для создания ментальных карт, после этого используйте iterm, чтобы открыть сгенерированный файл HTML. input_code:

markdown content

« Подумайте о процессе помещения слона в холодильник и представьте ментальную карту. Откройте ее с помощью терминала».

aiworkflow

mindmappinbrowser

и многое другое

Лицензия

Этот проект лицензирован по лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории этого проекта

Если этот проект был вам полезен, пожалуйста, поставьте ему звезду ⭐️

Развитие технологий должно приносить пользу всем людям, а не эксплуатировать население в целом.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

convert_markdown_to_mindmap

Сервер Model Context Protocol, который преобразует контент Markdown в интерактивные ментальные карты, позволяя помощникам на базе искусственного интеллекта визуализировать иерархическую информацию с помощью HTML-контента или сохраненных файлов.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Documentation Service
alekspetrov
A
security
A
license
A
quality
A Model Context Protocol implementation that enables AI assistants to interact with markdown documentation files, providing capabilities for document management, metadata handling, search, and documentation health analysis.
Last updated -
14
346
11
TypeScript
MIT License
Playwright MCP Server
Kotelberg
-
security
F
license
-
quality
A server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.
Last updated -
Fingertip MCP Serverofficial
fingertip-com
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Fingertip's site management capabilities, allowing them to list, view details of, and create websites.
Last updated -
1
TypeScript
MIT License
MCP Outline Server
Vortiago
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
19
Python
MIT License

View all related MCP servers

Mindmap MCP Server